Справочник HTTP-статусов

Для чего нужен справочник HTTP-статусов

Справочник HTTP-статусов показывает название и назначение кода ответа по номеру или термину. Карточки можно отфильтровать поиском и по классу ответа, чтобы быстрее разобраться в логе или сообщении API.

Что сообщает код HTTP

HTTP-статус является частью ответа сервера и описывает результат обработки запроса на уровне протокола. Первая цифра задает класс: 1xx для информационных ответов, 2xx для успеха, 3xx для перенаправлений и связанных условий, 4xx для ошибок запроса, 5xx для ошибок сервера.

Сам по себе код не описывает всю причину. Например, один 404 может возникнуть из-за неверного маршрута приложения, отсутствующего ресурса или настройки прокси. Для диагностики нужны также URL, метод, заголовки и тело ответа.

Ответ протокола и ошибка бизнес-операции

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

При проектировании API согласуйте, какие ситуации выражаются HTTP-статусом, а какие деталями тела. Клиент должен понимать обе части контракта. Справочник не проверяет, насколько последовательно конкретный сервис использует эти соглашения.

Перенаправление и кэширование

Ответ класса 3xx не всегда означает простую ошибку или необходимость вручную исправить ссылку. Перенаправление может указать другой адрес, а условный запрос с 304 позволяет использовать ранее сохраненное представление. Для понимания результата нужно смотреть сопутствующие заголовки и контекст запроса.

При разборе логов также учитывайте метод. Например, у ответа на HEAD нет обычного тела представления, хотя статус сообщает результат проверки ресурса. Само отсутствие тела не превращает успешный статус в ошибку. Для наблюдения за цепочкой переходов нужен отдельный запрос к сайту, а не поиск номера в этом справочнике.

Как найти описание кода

Введите число или слово в «Код или термин». Поиск учитывает название и пояснение, выдача меняется автоматически. Кнопки классов дополнительно ограничивают видимые карточки. При пустом запросе доступны все записи справочника.

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

Статус ответа и фактическая работа приложения

200 не подтверждает правильность данных внутри страницы, а ошибка бизнес-операции может быть описана в теле ответа при успешном HTTP-обмене. И наоборот, сетевой обрыв без полученного HTTP-ответа вообще не имеет статуса сервера.

Эта страница является справочником и не запрашивает адрес сайта. Для получения ответа конкретного публичного URL используйте проверку HTTP-кода, затем сопоставьте результат с описанием статуса.