Быстрый список кодов состояния HTTP с поиском
Каждый раз, когда браузер, мобильное приложение или поисковый робот отправляет запрос к веб-серверу, сервер отвечает трехзначным числом. Эти коды состояния HTTP сообщают клиенту, что именно произошло: выполнен ли запрос успешно, произошла ли ошибка, требуется ли авторизация или перенаправление.
Этот инструмент представляет собой полный справочник стандартных кодов ответа HTTP с удобным поиском на основе официальных спецификаций RFC. Поскольку весь список загружается и фильтруется локально в вашем браузере, поиск работает мгновенно. Вам не придется ждать перезагрузки страницы, чтобы узнать разницу между кодами 301 и 302 или понять, что означает ошибка 422.
Пять классов кодов ответа HTTP
Коды HTTP делятся на пять классов в зависимости от первой цифры. Понимание этих категорий — самый быстрый способ выявить проблемы с веб-трафиком:
1xx (Информационные)
Эти коды означают, что сервер принял запрос и продолжает его обработку. Это временные ответы, поэтому клиенту нужно дождаться итогового результата. Например, 100 Continue сообщает клиенту, что можно продолжать и отправлять тело запроса.
2xx (Успешные)
Код 2xx означает, что запрос клиента успешно получен, понят и принят. Самый частый из них — 200 OK, стандартный ответ при успешном HTTP-запросе. При создании новой записи через API обычно возвращается 201 Created.
3xx (Перенаправление)
Эти коды сообщают клиенту, что для выполнения запроса нужны дополнительные действия. Как правило, это означает, что запрашиваемый ресурс перемещен. Код 301 Moved Permanently указывает поисковикам обновить ссылки, а 302 Found означает временное перемещение.
4xx (Ошибка клиента)
Коды ошибок HTTP в диапазоне 4xx означают, что проблема возникла на стороне клиента. Запрос может содержать синтаксическую ошибку, не пройти аутентификацию или обращаться к несуществующему ресурсу. Такие ошибки часто возникают из-за опечаток в URL или при отправке некорректных данных через API.
5xx (Ошибка сервера)
Код 5xx означает, что сервер не смог выполнить корректный запрос. Клиент всё сделал правильно, но на сервере произошла внутренняя ошибка, сбой или он в данный момент перегружен.
Распространенные коды ошибок HTTP, которые нужно знать
Существуют десятки кодов, но разработчики и вебмастеры чаще всего сталкиваются лишь с несколькими из них:
Код состояния 404 (Not Found)
Пожалуй, самая известная ошибка в интернете. Код 404 означает, что сервер не смог найти запрошенный ресурс. Владельцам сайтов крайне важно отслеживать ошибки 404 для SEO, поскольку битые ссылки раздражают пользователей и впустую расходуют краулинговый бюджет.
400 Bad Request
Сервер не может обработать запрос из-за ошибки на стороне клиента, например, из-за неверного синтаксиса запроса или неправильной маршрутизации. API часто возвращают этот код, если отсутствует обязательный параметр.
401 Unauthorized & 403 Forbidden
Оба кода связаны с доступом. 401 Unauthorized означает, что клиенту необходимо пройти аутентификацию для получения ответа (например, отсутствует API-ключ). 403 Forbidden означает, что личность клиента известна, но у него нет необходимых прав для доступа к ресурсу.
500 Internal Server Error
Это универсальный код для сбоев на стороне сервера. Он означает, что сервер столкнулся с непредвиденной ситуацией, которая не позволила ему выполнить запрос. При возникновении ошибки 500 обычно нужно изучить логи приложения на сервере, чтобы найти первопричину.
502 Bad Gateway & 503 Service Unavailable
Ошибка 502 Bad Gateway возникает, когда сервер, выступающий в роли прокси (например, Nginx или балансировщик нагрузки), получает некорректный ответ от upstream-сервера. 503 Service Unavailable означает, что сервер в данный момент не может обработать запрос, чаще всего из-за перегрузки или проведения технических работ.
Лучшие практики разработки API
При разработке REST API возврат корректных HTTP-кодов состояния крайне важен для удобства разработчиков. Возврат 200 OK при фактической ошибке (так называемое «проглатывание» ошибок) заставляет клиентов вручную парсить тело ответа, чтобы понять, успешно ли выполнен запрос.
Используйте этот справочник для выбора наиболее семантически верного кода. Например, возвращайте 429 Too Many Requests при превышении лимита запросов или 422 Unprocessable Content, если JSON-данные валидны, но не проходят проверку бизнес-логики.
Если вы разбираетесь с проблемами маршрутизации на сервере, вам также может пригодиться инструмент Проверка DNS для анализа доменных записей или Парсер User-Agent для определения клиентов, отправляющих запросы к вашему серверу. А для управления индексацией сайта поисковыми системами и предотвращения ошибок 404 попробуйте Генератор robots.txt.