Что такое статус-код 204?

Ответ на вопрос: Что такое статус-код 204?

Статус-код 204 — это один из кодов состояния из категории «Успешные» (2xx) в протоколе HTTP (HyperText Transfer Protocol). Он имеет официальное название «No Content». Этот код указывает, что сервер успешно выполнил запрос клиента, но не возвращает никакого содержимого (контента) в теле ответа.

Основное предназначение и сценарии использования

Основная идея статуса 204 — подтвердить успешное выполнение операции, которая не требует передачи данных клиенту. Это отличает его от, например, 200 OK, который обычно сопровождается данными (HTML, JSON, файлом).

Ключевые сценарии применения:

• Операции UPDATE/PATCH в REST API: Когда клиент отправляет данные для обновления ресурса (например, через PUT или PATCH), и обновление успешно выполнено, но нет необходимости возвращать весь обновленный объект. Сервер может ответить 204, подтверждая успех.
• Операции DELETE в REST API: После успешного удаления ресурса часто возвращается 204. Возвращать тело ответа при удалении обычно не имеет смысла.
• Успешные операции без возврата данных: Любые действия, где результат — просто факт успешного выполнения (например, подтверждение получения команды, очистка очереди).
• Ответ на запросы с заголовком Expect: 100-continue: Сервер может использовать 204 для предварительного подтверждения готовности принять данные.
• Операции, изменяющие состояние на стороне сервера: Например, сброс счетчика или флага, где клиенту нужно только знать, что операция прошла.

Технические особенности и важные детали для QA Engineer

1. Пустое тело ответа: При получении 204 тело ответа (response body) должно быть пустым. Серверы не должны отправлять никакие данные после заголовков. Браузеры и клиенты не изменяют текущую страницу/документ при получении такого ответа.
2. Заголовки могут присутствовать: Сервер может и должен отправлять необходимые заголовки (например, Date, Server, потенциально Cache-Control), даже если тело пустое.
3. Не 200 OK: Важно понимать разницу. 200 OK подразумевает «вот ваш результат». 204 No Content — «операция выполнена, но результата для передачи нет».
4. Критично для тестирования API: При тестировании RESTful API проверка возврата корректного статус-кода — одна из основных обязанностей QA. Для операций удаления или обновления ожидаемый ответ часто — именно 204.

Пример для понимания

Рассмотрим сценарий тестирования API для управления списком пользователей.

# Пример запроса DELETE для удаления пользователя
DELETE /api/users/123 HTTP/1.1
Host: example.com
Authorization: Bearer token123

Ожидаемый успешный ответ:

HTTP/1.1 204 No Content
Date: Mon, 01 Jan 2024 12:00:00 GMT
Server: Apache
Connection: close

В теле ответа ничего нет. Клиент (или наш тест) понимает, что пользователь с ID 123 был удален.

Что проверять при тестировании ответа с статусом 204?

Как QA Engineer, вы должны убедиться в следующем:

• Код состояния точно 204, а не 200 или любой другой.
• Тело ответа действительно пустое. Это можно проверить:

    * В инструментах типа Postman или Swagger — убедиться, что в секции «Body» ничего нет.
    * Написать автоматизированный тест, который проверяет длину тела ответа.

• Запрос был выполнен успешно. Недостаточно просто получить код 204; необходимо проверить, что соответствующее действие на сервере действительно произошло (например, пользователь удален из базы данных, значение обновлено).
• Клиентское приложение корректно обрабатывает этот статус. Особенно важно в frontend-тестировании: убедиться, что после получения 204 приложение не пытается «распарсить» пустое тело как JSON (что может вызвать ошибку), а выполняет логику, предусмотренную разработчиками (например, закрывает модальное окно или удаляет элемент из UI).

Частые ошибки и проблемы

• Сервер возвращает 204 с телом ответа — это нарушение стандарта. Тело должно быть пустым.
• Сервер возвращает 200 с пустым телом вместо 204 — это менее критично, но не идеально с точки зрения семантики REST.
• Клиент ожидает данные (например, обновленный объект после PUT), но получает 204 и «ломается» — это проблема согласования между клиентом и сервером, которую тоже можно выявить при тестировании интеграции.

В заключение, статус-код 204 No Content — важный и семантически точный инструмент в HTTP, позволяющий четко коммуницировать об успешном выполнении операций, не требующих возврата данных. Для QA Engineer понимание этого кода и его правильное тестирование — ключевая часть обеспечения качества REST API и веб-приложений.