В каких случаях возвращается код 400 Bad Request? Приведите примеры для нашего API.

Код ответа 400 Bad Request возвращается, когда запрос клиента некорректен или не может быть обработан из-за ошибок в синтаксисе или логике запроса.

Примеры для нашего API:

• Отсутствие обязательных параметров в теле запроса или в URL.
• Неверный формат данных, например, строка вместо числа, неправильный JSON.
• Нарушение валидации, например, длина строки превышает допустимый лимит.
• Отправка неподдерживаемого типа контента.

Пример:

Если API ожидает POST-запрос с JSON, содержащим поле "email", и клиент отправляет:

{
  "email": "not-an-email"
}

и при этом есть валидация формата email, сервер вернёт 400 с сообщением об ошибке.

Таким образом, 400 сигнализирует, что клиент должен исправить запрос перед повторной отправкой.