Sobes.tech
Middle

Per l'endpoint POST /api/tasks (creazione di un compito): 1) Quali parametri di input sono necessari? 2) Quali parametri di servizio per autenticazione e autorizzazione? 3) Fornisci un esempio di richiesta JSON valida con un array di tag_ids. 4) Quali codici di stato HTTP di risposta utilizzeresti?

sobes.tech AI

Risposta dell'AI

  1. Входные параметры для POST /api/tasks:
  • title (string) — название задачи, обязательное.
  • description (string) — описание задачи, необязательное.
  • due_date (string, формат ISO 8601) — дата выполнения, необязательное.
  • priority (string или int) — приоритет задачи, необязательное.
  • tag_ids (массив int) — идентификаторы тегов, связанных с задачей, необязательное.
  1. Служебные параметры для аутентификации и авторизации:
  • Заголовок Authorization: Bearer <token> — токен доступа пользователя.
  • Возможно, дополнительные заголовки или куки, если используется сессия.
  1. Пример валидного JSON запроса:
{
  "title": "Сделать отчёт",
  "description": "Подготовить отчёт по продажам за месяц",
  "due_date": "2024-07-01T18:00:00Z",
  "priority": "high",
  "tag_ids": [12, 34, 56]
}
  1. HTTP статусы ответа:
  • 201 Created — задача успешно создана.
  • 400 Bad Request — неверный формат или отсутствуют обязательные поля.
  • 401 Unauthorized — отсутствует или недействительный токен аутентификации.
  • 403 Forbidden — пользователь не имеет прав на создание задачи.
  • 500 Internal Server Error — внутренняя ошибка сервера.

Такой набор статусов покрывает основные сценарии взаимодействия с API.