Sobes.tech
Middle

Pentru endpoint-ul POST /api/tasks (crearea unei sarcini): 1) Ce parametri de intrare sunt necesari? 2) Ce parametri de serviciu pentru autentificare și autorizare? 3) Furnizați un exemplu de solicitare JSON validă cu un array de tag_ids. 4) Ce coduri de stare HTTP de răspuns ați folosi?

sobes.tech AI

Răspuns de la 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.