422
Ошибки клиента
422 Unprocessable Entity
Сервер понимает тип контента, но не может обработать инструкции из-за семантических ошибок.
Определение (RFC 9110)
HTTP-код 422 422 Unprocessable Entity определён в RFC 9110 (HTTP Semantics), раздел 15.5.21 — действующей спецификации семантики HTTP (июнь 2022), которая заменила устаревшие RFC 7231 и RFC 2616.
Описание
422 Unprocessable Entity (изначально WebDAV, теперь стандартизирован в RFC 9110) означает, что сервер понимает тип контента и синтаксис корректен, но не может обработать инструкции из-за семантических ошибок.
В REST API это предпочтительный код для ошибок валидации: запрос синтаксически корректный JSON/XML, но нарушает правила бизнес-логики.
Частые причины
- API-запрос с валидным JSON, но провалившейся валидацией полей
- Отправка формы с невалидными данными (неверный email, слишком короткий пароль)
- Нарушение бизнес-правила (дата бронирования в прошлом, отрицательное количество)
- WebDAV-операция с конфликтующими свойствами
Как исправить
- Возвращайте подробные ошибки валидации по каждому полю в теле ответа
- Используйте единый формат ошибок:
{"errors": [{"field": "email", "message": "Неверный формат"}]} - Разграничивайте 400 (некорректный синтаксис) и 422 (верный синтаксис, провал валидации)
- Документируйте все правила валидации в API-документации
Проверьте HTTP-статус вашего сайта
Проверить →