Server response 422 Unprocessable Entity

HTTP статус-код 422 (Unprocessable Entity)

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

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

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

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

Неправильный формат данных
Отсутствие обязательных полей
Неподдерживаемые значения в полях

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

Неправильный формат данных
Отсутствие обязательных полей
Неподдерживаемые значения в полях

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

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

Клиент отправляет данные формы на сервер. Если сервер обнаруживает ошибки валидации, он может вернуть ответ с кодом 422, указывая на конкретные ошибки:

{
    "errors": {
        "username": "Имя пользователя обязательно.",
        "email": "Некорректный адрес электронной почты."
    }
}

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

В случае, если сервер не может обработать входящие данные, он возвращает статус-код 422 с сообщением об ошибке. Например:

{
    "error": "Неподдерживаемый формат данных."
}

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

Когда пользователь пытается загрузить файл неподходящего формата, сервер может вернуть статус-код 422:

{
    "error": "Файл должен иметь формат JPEG или PNG."
}

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

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

Пример кода, который вызывает ошибку:

let data = { username: "", email: "invalid email" };

Как изменить код для корректной обработки данных:

if (!data.username) {
    throw new Error("Имя пользователя обязательно.");
}

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

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

def validate_data(data):
    if 'email' not in data:
        raise ValueError("Email обязателен.")

Как использовать валидацию данных для предотвращения ошибки:

if not is_valid_email(data['email']):
    raise ValueError("Некорректный адрес электронной почты.")

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

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

$response = api_call($data);
if ($response->status_code == 422) {
    echo "Ошибка: " . $response->error;

Как настроить сервер для правильной обработки входящих данных:

if (empty($data['username'])) {
    throw new Exception("Имя пользователя обязательно.");
}

Язык программирования	Пример ошибки	Способ исправления
JavaScript	Пустое имя пользователя	Добавить проверку на наличие имени
Python	Отсутствие обязательного поля	Использовать валидацию данных
PHP	Некорректные данные	Настроить обработку ошибок на сервере