Коды состояния HTTP

Что предлагает страница «Коды состояния HTTP»

Коды состояния HTTP — это справочник с поиском по кодам ответов в диапазоне от 100 до 599. Он помогает при отладке вызовов API, написании документации, выборе ответа для нового эндпоинта, чтении журналов, проверке поведения шлюза или объяснении сбоя другому разработчику. Каждая запись содержит числовой код, поясняющую фразу, категорию и краткое описание того, что обычно означает этот ответ. Фильтр сопоставляет коды, названия, категории и описания, поэтому можно искать точные значения, например 404, широкие группы, например redirect, или понятия вроде cache, auth, proxy, timeout и валидация.

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

Приватная работа в браузере

Вся обработка выполняется в вашем браузере с помощью клиентского JavaScript. Инструмент не загружает на сервер фрагменты, значения конфигурации, сгенерированные данные, тексты запросов или скопированные примеры и не требует учётной записи. Такая исключительно локальная модель важна для инструментов разработчика, ведь вставляемое содержимое часто похоже на реальные данные приложения: ответы API, журналы, образцы в духе переменных окружения, запросы к базе данных, разметку из черновиков или значения, скопированные при отладке в продакшене. Локальная обработка снижает риски и ускоряет работу, так как нет обмена данными по сети.

Интерфейс намеренно компактен: вы вставляете входные данные, настраиваете параметры, проверяете результат, копируете его и возвращаетесь в редактор. Результаты всё равно нужно проверять перед коммитом, публикацией или использованием в рабочем процессе продакшена. Браузерные инструменты отлично подходят для быстрой проверки и подготовки, но они не знают всех соглашений проекта, правил классификации данных и требований к валидации, специфичных для вашего приложения.

Практические советы

Коды состояния — часть контракта API, поэтому выбирайте их осознанно. Используйте ответы семейства 400, когда клиент может изменить запрос, семейства 500, когда сервер не смог выполнить корректный запрос, и семейства 300, когда клиенту следует поискать ресурс в другом месте. Ошибки аутентификации и авторизации часто путают: 401 обычно означает, что аутентификация требуется или недействительна, а 403 — что аутентифицированному пользователю доступ запрещён. При документировании API сопоставляйте код со схемой тела ответа и рекомендациями по устранению проблемы.