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

Коды HTTP-статусов — это трёхзначные числа, которые сервер возвращает в ответ, чтобы описать результат вашего запроса. 200 означает успешное выполнение, 404 — что страница не найдена, 500 — что на сервере произошла ошибка. Первая цифра делит коды на пять классов: 2xx — всегда успех, 5xx — всегда ошибка сервера. Зная класс, вы сразу понимаете, с чего начинать отладку: на стороне клиента или сервера.

Первая цифра определяет класс: 1xx Информационные (запрос получен и продолжается, например 100 Continue), 2xx Успешные (всё прошло, например 200 OK), 3xx Перенаправления (нужно перейти в другое место, например 301 Moved Permanently), 4xx Ошибки клиента (запрос неверный, например 404 Not Found), и 5xx Ошибки сервера (сервер не справился, например 500 Internal Server Error). Используйте фильтр по классу в инструменте выше, чтобы увидеть только нужную группу с объяснением каждого кода.

Те, с которыми сталкиваешься ежедневно: 200 OK, 201 Created, 204 No Content, редиректы 301 и 302, 304 Not Modified, 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found, 429 Too Many Requests, 500 Internal Server Error, 502 Bad Gateway и 503 Service Unavailable. Включите фильтр «Только основные» в инструменте выше, чтобы сократить полный список до этого набора с причинами и способами исправления для каждого.

200 OK — стандартный ответ об успехе: для GET он возвращает ресурс в теле ответа, для POST — результат выполнения действия. 201 Created означает, что POST или PUT выполнился успешно и создал новый ресурс; сервер, как правило, указывает адрес этого ресурса в заголовке Location, например Location: /users/42. Если вы разрабатываете API и создаёте ресурс, возвращайте 201 с заголовком Location, а не 200 — чтобы клиент знал, где найти новый объект.

404 означает, что сервер ничего не нашёл по этому URL — ресурс не существует, был перемещён или ссылка битая. Исправляют это так: проверяют URL на опечатки и правильный регистр букв, добавляют редирект 301 со старого адреса на новый, проверяют правила маршрутизации или перезаписи на сервере, а также настраивают информативную кастомную страницу 404. В отличие от 410 Gone, 404 не гарантирует, что ресурс исчез навсегда, поэтому поисковые роботы продолжают его обходить. MDN Web Docs содержит подробное описание спецификации, но этот инструмент показывает типичные причины и способы исправления прямо рядом с каждым кодом.

301 Moved Permanently сообщает, что ресурс навсегда переехал на новый адрес: поисковые системы переносят ссылочный вес на новый URL и обновляют индекс. Используйте его при постоянном изменении URL. 302 Found — временный перенос: исходный URL остаётся каноническим и сохраняет позиции, поэтому применяйте его для краткосрочных переходов — A/B-тестов или страницы технических работ. Для запросов методом, отличным от GET, используйте 308 (постоянный) или 307 (временный): они сохраняют HTTP-метод и не позволяют браузерам понизить POST до GET.

403 Forbidden означает, что сервер понял запрос, но отказывается его авторизовать — и в отличие от 401, отправка учётных данных не поможет. Типичные причины: недостаточно прав или разрешений у аккаунта, неверные права доступа к файлу на сервере (например, файл с правами 600 вместо 644), блокировка по IP или правило WAF, либо отключённый листинг директорий без файла index. Проверьте роли аккаунта, права на файлы и списки разрешённых адресов. Некоторые серверы намеренно возвращают 403 вместо 404, чтобы не раскрывать факт существования ресурса.

Все они относятся к классу 5xx, но означают разное. 500 Internal Server Error — общее «что-то сломалось», обычно необработанное исключение или баг в приложении. 502 Bad Gateway означает, что прокси получил неверный ответ от вышестоящего сервера приложений (тот, вероятно, упал). 503 Service Unavailable — сервер временно недоступен или перегружен; в ответе должен быть заголовок Retry-After. 504 Gateway Timeout — вышестоящий сервер был доступен, но не ответил достаточно быстро. На практике начинайте с серверных логов, чтобы различить эти ошибки.

429 означает, что вы превысили лимит запросов — слишком много обращений за заданный промежуток времени. Сервер должен вернуть заголовок Retry-After, указывающий, сколько ждать. Исправляют это, соблюдая этот заголовок, добавляя экспоненциальную задержку между попытками, кэшируя ответы для снижения объёма запросов или запрашивая увеличение квоты. Код часто встречается в публичных API и на страницах входа, защищающих от злоупотреблений. GitHub, Stripe и Twitter/X используют 429 для ограничения частоты обращений к API.

Ошибки 4xx — вина клиента: сам запрос неверен, поэтому повторная отправка без изменений не поможет (400 Bad Request, 401 Unauthorized, 404 Not Found). Ошибки 5xx — вина сервера: запрос может быть абсолютно правильным, но сервер не смог его выполнить (500, 502, 503), поэтому тот же запрос может успешно пройти после восстановления сервера. При 4xx исправляйте запрос, при 5xx — сервер. Это различие важно для логики повторных попыток: делайте их только при 5xx с экспоненциальной задержкой — при 4xx повторы лишь расходуют квоту.

Ключевые коды: 200 OK (все индексируемые страницы должны его возвращать), 301 Moved Permanently (передаёт ссылочный вес на новый URL при миграции), 302 Found (временный — сохраняет авторитет исходного URL), 404 Not Found и 410 Gone (сообщают роботам об отсутствии страницы; 410 исключается из индекса быстрее, поскольку означает окончательное удаление), и 503 Service Unavailable (безопасный для SEO код при плановом обслуживании — указывает Google вернуться позже, а не удалять страницы из индекса).

401 Unauthorized на самом деле означает «не аутентифицирован» — вы не подтвердили личность, поэтому отправка правильных учётных данных (токена, ключа API или сессии) может решить проблему; сервер должен ответить заголовком WWW-Authenticate. 403 Forbidden означает, что вы аутентифицированы, но у вас просто нет доступа к этому ресурсу — лучшие учётные данные не помогут, нужны другие права. Простое правило: 401 = кто вы такой, 403 = вам это нельзя.

Все четыре являются редиректами, но 307 и 308 гарантируют сохранение исходного HTTP-метода и тела запроса, тогда как 301 и 302 исторически позволяют клиентам заменить POST на GET при перенаправлении. Поэтому 301 (постоянный) и 302 (временный) подходят для обычных редиректов страниц, но если эндпоинт принимает данные POST или PUT — используйте 308 для постоянных переносов и 307 для временных, чтобы сохранить метод и избежать потери данных.

Коды в диапазоне 520–530 — это нестандартные коды, которые Cloudflare возвращает при сбоях между Cloudflare и вашим исходным сервером. Их нет в официальной спецификации HTTP, но за Cloudflare вы будете встречать их постоянно. 520 означает, что источник вернул пустой или неожиданный ответ, 521 — что источник отверг соединение (не работает или блокирует IP Cloudflare), 522 — таймаут TCP-соединения, 523 — недоступность источника, 524 — источник подключился, но не ответил в течение 100 секунд, 525 и 526 — ошибки SSL-рукопожатия и сертификата, 530 — как правило, ошибка DNS источника вместе с кодом 1xxx. Введите любой из этих номеров выше, чтобы увидеть причины и способы исправления.

MDN Web Docs — авторитетный справочник по спецификации, но там нет строки живого поиска по всем кодам сразу, нет фильтра по классу и компактного режима шпаргалки — вы переходите на отдельную страницу для каждого кода. httpstatuses.com показывает коды в сетке, но не объясняет причины и не даёт практических советов по исправлению. restapitutorial.com охватывает REST-конвенции без интерактивного поиска. HTTP.cat — забавный мем-сайт (каждый код соответствует фото кота), но для реальной отладки бесполезен. Этот инструмент объединяет поиск, фильтр по классу, режим шпаргалки, причины, способы исправления, коды Cloudflare 5xx (которые большинство справочников пропускает) — всё на одной странице, работающей офлайн без рекламы и регистрации.

Полностью. Весь список загружается как статичные данные внутри страницы, поэтому каждый поиск, фильтрация и запрос выполняются локально в вашем браузере — ничего не загружается, не записывается в лог и не отправляется на сервер. Это также означает мгновенную загрузку и работу офлайн после открытия страницы. Никакой регистрации, аккаунта, лимитов запросов и платного доступа. Просто быстрый и приватный справочник, одинаково удобный на телефоне и на компьютере.