Ответ сервера 422 Unprocessable Entity

Определение и применение статус-кода 422

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

Что означает статус-код 422?

Статус-код 422 сигнализирует о том, что запрос был корректно сформирован, но сервер не может его выполнить из-за ошибок в переданных данных. Это может быть связано с различными проблемами, включая, но не ограничиваясь, неверным форматом данных, отсутствием обязательных полей или неподдерживаемыми значениями в полях.

Ситуации, в которых может возникнуть ошибка:

Неправильный формат данных: Например, передача строки вместо числа.
Отсутствие обязательных полей: Если запрос не содержит всех необходимых параметров.
Неподдерживаемые значения в полях: Когда переданные значения не соответствуют ожидаемым.

Практические примеры использования статус-кода 422

Пример 1: Ошибка валидации формы

Предположим, клиент отправляет данные формы, содержащие недопустимые значения. Сервер, в свою очередь, отвечает кодом 422 с описанием ошибок валидации.

Пример 2: Обработка данных API

Когда сервер получает данные, которые он не может обработать из-за ошибок в структуре или логике, он также возвращает статус 422 с подробным описанием проблем.

Пример 3: Работа с файлами

Если клиент пытается загрузить файл неподходящего формата, сервер может вернуть статус 422 с указанием причины ошибки.

Исправление ошибок, вызывающих статус-код 422

Исправление на языке JavaScript

Рассмотрим пример кода, который вызывает ошибку 422:


const data = {
    name: "John Doe",
    age: "нечисло" // некорректный формат
};
fetch('/api/user', {
    method: 'POST',
    headers: {
        'Content-Type': 'application/json'
    },
    body: JSON.stringify(data)
});

Для корректной обработки данных следует убедиться, что все поля имеют правильные типы данных.

Исправление на языке Python

Рассмотрим пример некорректного запроса:


data = {
    "username": "",
    "email": "invalid-email"
}
response = requests.post("http://example.com/api", json=data)

Использование библиотеки для валидации данных поможет предотвратить ошибку 422.

Исправление на языке PHP

Пример вызова API с ошибочными данными:


$data = [
    'name' => 'John',
    'age' => 'недопустимо'
];
$response = $client->post('/api/user', ['json' => $data]);

Настройка сервера для правильной обработки входящих данных включает валидацию на уровне серверного кода.

Тип ошибки	Пример	Решение
Неправильный формат данных	Строка вместо числа	Проверка типов перед отправкой
Отсутствие обязательных полей	Пропущенное поле email	Валидация на стороне клиента
Неподдерживаемые значения	Значение 'неизвестно'	Использование фиксированного списка допустимых значений