Справочник кодов состояния HTTP

Справочник кодов состояния HTTP — это полный интерактивный указатель всех кодов состояния, определенных в спецификациях HTTP, от 100 Continue до 511 Network Authentication Required. Каждая запись содержит каноническое название, определяющий его стандарт RFC, реальное значение кода, информацию о том, когда его следует отправлять, когда не следует, и типичные ошибки, с которыми сталкиваются реальные кодовые базы. Живой фильтр и вкладки категорий позволяют переходить от класса к классу в один клик.

В отличие от обычной шпаргалки, этот инструмент предоставляет для каждого кода отдельную микространицу с тремя цветовыми панелями (делать / не делать / подводные камни) и готовыми к вставке обработчиками для Express.js, Django, FastAPI и Go net/http. Анимированная схема наглядно показывает путь запроса от клиента к серверу и возвращаемый обратно код состояния, что особенно полезно для новичков, изучающих, как коды состояния передаются по сети.

Почему важен справочник кодов состояния HTTP

Как использовать Справочник кодов состояния HTTP

1. Быстрый поиск. Введите код (404) или часть названия (teapot, gateway) в поле поиска наверху и нажмите кнопку отправки. Соответствующая запись откроется с полной панелью подробностей.
2. Просмотр по классам. Нажмите на любую из 5 категорий (1xx, 2xx, 3xx, 4xx, 5xx), чтобы отфильтровать сетку карточек по этому классу. Нажмите Все для сброса.
3. Живой фильтр. Поле фильтра прямо над сеткой сужает список карточек по мере ввода текста — удобно, если вы помните только половину названия, например too many или precondition.
4. Изучение кода. Нажмите на любую карточку, чтобы открыть детальную панель. Вы увидите значение, сценарии использования, предостережения, частые ошибки и блок кода для 4 фреймворков.
5. Копирование фрагментов. Используйте переключатель вкладок и небольшую кнопку Копировать, чтобы забрать готовый к вставке код.
6. Сравнение соседних кодов. Панель сведений заканчивается карточками соседних кодов из того же класса (1xx / 2xx / 3xx / 4xx / 5xx) для быстрого параллельного сравнения.

Обзор пяти классов кодов состояния HTTP

Часто путаемые пары

• 401 против 403. 401 означает не аутентифицирован — в запросе отсутствуют действительные учетные данные. 403 означает аутентифицирован, но доступ запрещен — учетные данные верны, но у пользователя нет необходимых прав.
• 404 против 410. 404 означает неизвестен: возможно, ресурс существует где-то еще, либо допущена опечатка. 410 означает намеренно удален: поисковые системы должны исключить эту страницу из своего индекса.
• 301 против 302 против 307 против 308. Коды 301 / 308 являются постоянными (308 строго сохраняет метод и тело запроса), а 302 / 307 — временными (307 строго сохраняет метод и тело запроса). Используйте 307 / 308 для перенаправлений методов POST / PUT / PATCH.
• 400 против 422. 400 означает, что тело запроса составлено некорректно (невалидный JSON, пропущено обязательное поле). 422 означает, что тело успешно распарсилось, но значения не проходят бизнес-правила (неверный формат email, количество выходит за допустимые рамки).
• 502 против 503 против 504. 502 означает, что вышестоящий сервер вернул некорректный ответ. 503 означает, что сервер перегружен или находится на обслуживании. 504 означает, что вышестоящий сервер не ответил вовремя.
• 409 против 412. 409 указывает на конфликт с текущим состоянием ресурса. 412 конкретно означает, что заголовок предварительного условия (If-Match, If-Unmodified-Since) вернул false при вычислении.

Заголовки, привязанные к определенным кодам состояния

• 201 Created — должен включать заголовок Location, указывающий на новый созданный ресурс.
• 301 / 302 / 307 / 308 — обязаны включать заголовок Location с целевым URL.
• 304 Not Modified — должен дублировать заголовки, которые были бы отправлены при коде 200 (ETag, Cache-Control, Vary).
• 401 Unauthorized — обязан содержать заголовок WWW-Authenticate со списком поддерживаемых схем (Basic, Bearer).
• 405 Method Not Allowed — должен включать заголовок Allow со списком разрешенных методов.
• 413 / 429 / 503 — часто включают заголовок Retry-After (в секундах или в формате HTTP-date), чтобы клиенты знали, когда повторить попытку.
• 416 Range Not Satisfiable — обязан включать заголовок Content-Range: bytes */<length>.

Коды состояния, которые почти всегда можно игнорировать

Ряд кодов технически валиден, но крайне редко встречается в современных API: 305 Use Proxy (устарел), 306 (зарезервирован, не используется), 305, 506 Variant Also Negotiates, 510 Not Extended и 508 Loop Detected. Большинство из них хранятся в реестре по историческим причинам. Если ваша библиотека или middleware возвращает один из них, скорее всего, это баг самой библиотеки, а не повод писать под него специальную логику обработки.

FAQ

Включает ли инструмент коды из других RFC, помимо 9110?

Да. Справочник охватывает RFC 9110 (семантика HTTP), RFC 6585 (дополнительные коды 4xx / 5xx), RFC 4918 (WebDAV), RFC 5842 (привязки WebDAV), RFC 7725 (451), RFC 8297 (103 Early Hints), RFC 8470 (425 Too Early) и знаменитый шуточный RFC 2324 (418 Teapot).

Действительны ли эти коды в HTTP/2 и HTTP/3?

Да. Семантика кодов состояния определена в RFC 9110, который является документом по семантике HTTP, не зависящим от версии. Стандарты HTTP/2 (RFC 9113) и HTTP/3 (RFC 9114) меняют только фрейминг и механизмы транспорта.

Можно ли сослаться напрямую на конкретный код?

Отправьте форму с одним кодом (например, 404), и панель с подробным описанием загрузится под формой. URL-адрес страницы сохранит параметры вашего поиска, и им можно делиться с другими пользователями — при его открытии отобразится тот же результат.

Почему мой фреймворк не позволяет возвращать код 418?

Старые версии некоторых HTTP-библиотек отказываются отправлять коды, отсутствующие в их внутреннем реестре. Решением является обновление библиотеки или, где это возможно, запись строки статуса вручную.

Должен ли API когда-либо возвращать код 200 с телом ошибки?

Нет. Системы мониторинга, механизмы повторных запросов и промежуточные прокси-серверы исходят из того, что класс 2xx означает успех. Если вам нужно передать структуру ошибки, верните подходящий код 4xx или 5xx, а структурированные детали поместите внутрь тела ответа. Отличным шаблоном для этого является формат Problem Details для HTTP API (RFC 9457).

Существует ли авторитетный реестр кодов состояния HTTP?

Да. IANA поддерживает официальный реестр по адресу iana.org/assignments/http-status-codes. Данный инструмент синхронизируется с этим реестром, а также с наиболее часто цитируемыми стандартами RFC.