422 Unprocessable Entity ("необрабатываемый экземпляр")

https://httpcat.ru/422

Это прямая ссылка на изображение со статусом. Вы можете скопировать и использовать её где угодно.

Описание

Код состояния 422 Unprocessable Entity означает, что сервер понимает формат запроса, но не может его обработать из-за логических ошибок в переданных данных (например, ошибки валидации).

Основные характеристики:

Запрос имеет корректный синтаксис и формат (например, JSON правильный), но его содержимое **не может быть принято**
Часто используется в API для возврата ошибок валидации полей
Был введён в WebDAV (RFC 4918), но широко применяется за его пределами

Типичное использование:

POST /api/users HTTP/1.1
Content-Type: application/json

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

HTTP/1.1 422 Unprocessable Entity
Content-Type: application/json

{
    "errors": {
        "email": "Invalid email format",
        "password": "Password is required"
    }
}

Особенности заголовков:

Content-Type — обычно application/json с пояснением, какие поля не прошли проверку
Content-Length — указывает размер тела ответа

Когда использовать:

При ошибках валидации формы (например, отсутствуют обязательные поля или данные в неверном формате)
Когда переданные значения логически противоречат правилам бизнес-логики
В REST API, при отклонении корректно оформленного, но неверного по содержанию запроса

Дополнительно:

Отличие от 400 Bad Request: 422 означает, что синтаксис верен, но данные неприемлемы
Может использоваться при частичных обновлениях (PATCH), если один из параметров некорректен
Поддерживается большинством современных веб-фреймворков как стандарт для ошибок валидации

Документация: https://developer.mozilla.org/en-US/docs/Web/HTTP/Status/422