Справочник кодов состояния HTTP — бесплатно

Используется для запросов с Expect: 100-continue. Сервер подтверждает готовность получить тело перед отправкой клиентом. Редко встречается в современных веб-приложениях.

Чаще всего используется для обновления WebSocket — клиент запрашивает Upgrade: websocket, а сервер отвечает 101 для переключения.

Промежуточный ответ WebDAV, отправляемый для предотвращения тайм-аутов клиента при длительных операциях. Устарел — современные серверы не должны его отправлять.

Позволяет серверам отправлять заголовки Link (preload/preconnect) пока финальный ответ ещё готовится, чтобы браузеры могли раньше начать загружать критические ресурсы.

Стандартный ответ об успехе. Значение зависит от HTTP-метода: GET → ресурс возвращён, POST/PUT → действие выполнено.

Частый ответ после POST. Ответ должен включать заголовок Location, указывающий на URL нового ресурса.

Для асинхронных операций — сервер ставит работу в очередь. Клиент должен опросить конечную точку статуса или проверить позже.

Запрос выполнен, но промежуточный узел (например, кэширующий или трансформирующий прокси) изменил полезную нагрузку с исходного сервера — например, переупаковал изображения. На практике редко.

Часто используется для операций DELETE или обновлений PUT, которым не нужно возвращать тело. Клиент не должен уходить с текущей страницы.

Как 204, тело не возвращается — но клиенту также указано сбросить форму или представление, которое произвело запрос (например, очистить поля формы для следующей записи).

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

WebDAV: тело в формате XML сообщает результат нескольких подопераций независимо — например, пакетное перемещение, где некоторые элементы обработаны успешно, а другие с ошибкой.

WebDAV: используется внутри ответов 207 Multi-Status для предотвращения повторного перечисления членов одной и той же коллекции, когда привязки создают циклы.

Дельта-кодирование: сервер возвращает разницу с предыдущей версией вместо полного ресурса, экономя пропускную способность. Очень редко реализуется.

Сервер предлагает несколько вариантов (например, разные форматы или языки) и клиент должен выбрать один. Редко используется, так как автоматическое согласование содержимого обычно это решает.

Используйте для постоянного изменения URL — поисковые системы обновят свой индекс. SEO-авторитет передаётся новому URL.

Указывает, что редирект не является постоянным. Кэширование менее агрессивно, чем при 301. Используйте для ситуаций вроде «требуется вход, редирект на /login».

Используется после отправки POST — ответ говорит «ваш POST сработал, см. этот GET URL для результата». Браузеры всегда делают GET нового URL.

Ответ на условный запрос (с заголовками If-None-Match или If-Modified-Since). Экономит пропускную способность — тело не возвращается.

Если исходный был POST, редирект также использует POST. Современная альтернатива 302, когда сохранение метода важно.

Современная замена 301, когда вы хотите, чтобы POST-запросы остались POST-запросами после редиректа.

Типичные причины: неверный JSON в теле, неверные параметры запроса или отсутствующие обязательные поля. Проверьте тело запроса и заголовки.

Клиент должен включить учётные данные аутентификации (заголовок Authorization, cookie, токен). «Unauthorized» — неправильный термин — на самом деле это значит «не аутентифицирован».

Первоначально предназначено для цифровых платежей. Современное использование: API иногда возвращают 402, когда пользователь превысил платную квоту.

Отличается от 401 — пользователь ВОШЁЛ, но его учётная запись не имеет разрешения для этого ресурса. Проверьте логику ролей/разрешений.

Либо URL неверный, либо ресурс был удалён, либо он никогда не существовал. Серверы иногда возвращают 404 для скрытия того, что 403 была бы точнее.

Например, GET-запрос к конечной точке, которая принимает только POST. Ответ должен включать заголовок Allow, перечисляющий допустимые методы.

Клиент запросил тип содержимого, язык или кодировку (через Accept, Accept-Language, Accept-Encoding), которые сервер не может удовлетворить. Многие серверы пропускают строгое согласование и возвращают значение по умолчанию.

Как 401, но выданный прокси: клиент должен отправить учётные данные Proxy-Authorization. Встречается в корпоративных сетях с аутентифицирующими прокси.

Клиент слишком долго отправлял тело запроса или держал соединение неактивным. Повторите запрос.

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

Более строгое, чем 404 — сервер явно знает, что ресурс СУЩЕСТВОВАЛ, но был окончательно удалён. Поисковые системы удалят его из индекса.

Запрос был отклонён, так как отсутствовал заголовок Content-Length, а сервер отказывается обрабатывать тела неизвестного размера. Добавьте заголовок и повторите попытку.

Возвращается, когда условные заголовки, такие как If-Match или If-Unmodified-Since, не выполняются — обычно это оптимистичная блокировка: кто-то другой изменил ресурс с момента вашей версии. Получите ресурс заново и повторите попытку.

Обычно при загрузке больших файлов. Конфигурация сервера (nginx, apache) устанавливает максимальный размер тела. Проверьте конфигурацию сервера.

Обычно вызывается очень длинными строками запроса (например, кодирование данных в GET). Переключитесь на тело POST или увеличьте лимит сервера, если вы его контролируете.

Например, отправка application/xml на сервер, который принимает только application/json. Правильно установите заголовок Content-Type.

Заголовок Range запрашивает часть, которая не существует в файле — например, возобновление загрузки после конца файла. Ответ должен включать Content-Range с фактическим размером.

Отправляется, когда сервер не поддерживает Expect: 100-continue. Некоторые клиенты отправляют этот заголовок по умолчанию при больших POST-запросах; отключение его обычно решает проблему.

Апрельская шутка с 1998 года (RFC 2324). Некоторые реальные API используют её для шуток или обозначения устаревших конечных точек. Не для использования в production.

Обычно при повторном использовании соединения HTTP/2: запрос достиг сервера, который не настроен для целевого имени хоста. Клиент должен повторить попытку на новом соединении.

Например, JSON был корректно распарсен, но отсутствовало требуемое поле, или значение поля было вне диапазона. Распространено в ответах проверки REST API.

WebDAV: исходный или целевой ресурс заблокирован другим клиентом, поэтому операция не может быть выполнена. Дождитесь освобождения блокировки или разблокируйте её с правильным токеном.

WebDAV: в цепочке зависимых операций более раннее действие не удалось, поэтому эта операция не была выполнена. Посмотрите на более раннюю ошибку, чтобы найти первопричину.

Связано с TLS 1.3 0-RTT (ранние данные): сервер не будет рисковать обработкой возможно повторённого запроса. Клиент должен повторить попытку после завершения handshake.

Сервер отказывается обслуживать запрос по текущему протоколу, но будет после обновления — ответ включает заголовок Upgrade, указывающий требуемый протокол.

Сервер требует условные заголовки (такие как If-Match) для предотвращения конфликтов потери обновлений. Получите ресурс заново, сохраните его ETag и отправьте запрос повторно с If-Match.

Замедлитесь. Ответ должен включать заголовок Retry-After, указывающий, когда повторить попытку. Распространено с API, которые имеют квоты запросов.

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

Ресурс заблокирован по правовым причинам — цензура, судебные приказы или региональные правила. Номер является намёком на роман «451 градус по Фаренгейту».

Универсальный обработчик для ошибок на стороне сервера. Проверьте логи сервера для фактической причины: необработанное исключение, ошибка БД и т.д.

Например, сервер не распознает метод HTTP. Редко на практике — чаще вы увидите 405.

Обычно в архитектуре микросервисов. Ваш load balancer или reverse proxy получил неправильный ответ от backend сервиса.

Либо на обслуживании, либо перегружен. Ответ должен включать заголовок Retry-After. Часто возвращается во время развёртывания.

Backend сервис не ответил достаточно быстро. Проверьте здоровье upstream сервиса и конфигурацию timeout.

Основная версия HTTP запроса не поддерживается сервером. Почти никогда не встречается с современными клиентами.

Согласование содержимого привело к циклу: выбранный вариант сам настроен на согласование. Указывает на ошибку конфигурации сервера.

WebDAV-специфичный по происхождению, но иногда используется общими серверами. Означает, что сервер не может сохранить запрос из-за ограничений хранилища.

WebDAV: обработка запроса Depth: infinity вошла в цикл (например, циклические привязки). Операция была прервана.

Из устаревшей HTTP Extension Framework: сервер нуждается в дополнительной информации перед выполнением запроса. Практически не используется в современной сети.

Используется captive-порталами (Wi-Fi в отелях и аэропортах), чтобы указать, что пользователь должен войти в сеть перед доступом на внешние сайты.