Справочник кодов состояния HTTP
| Код | Имя | Значение |
|---|---|---|
| 100 | Продолжить | Клиент должен продолжить телом запроса |
| 101 | Переключение протоколов | Обновление протокола принято (например, до WebSocket) |
| 200 | OK | Запрос выполнен успешно — ответ об успехе по умолчанию |
| 201 | Создано | Был создан новый ресурс (типичный успех POST) |
| 202 | Принято | В очереди на асинхронную обработку, ещё не завершено |
| 204 | Нет содержимого | Успех с намеренно пустым телом |
| 301 | Перемещено навсегда | У ресурса новый постоянный URL — обновите ссылки; SEO-ценность переносится |
| 302 | Найдено | Временная переадресация (исторически использовалась неправильно; см. 303/307) |
| 303 | См. другое | Переадресация на GET по другому URL (post/redirect/get) |
| 304 | Не изменено | Кэшированная копия всё ещё действительна — повторно проверьте через ETag/Last-Modified |
| 307 | Временная переадресация | Временная переадресация с сохранением метода и тела |
| 308 | Постоянная переадресация | Постоянная переадресация с сохранением метода и тела |
| 400 | Неправильный запрос | Сервер не может разобрать/понять запрос |
| 401 | Не авторизовано | Требуется аутентификация или она не удалась (несмотря на название, это означает «без аутентификации») |
| 403 | Запрещено | С аутентификацией или без неё доступ запрещён |
| 404 | Не найдено | По этому URL нет ресурса |
| 405 | Метод не разрешён | Метод HTTP не поддерживается для этого ресурса |
| 406 | Неприемлемо | Никакое представление не соответствует заголовкам Accept |
| 408 | Время ожидания запроса истекло | Клиент слишком долго отправлял запрос |
| 409 | Конфликт | Конфликт состояния, например столкновение при редактировании или дублирующее создание |
| 410 | Больше не доступен | Удалено навсегда (сильнее, чем 404, — используется намеренно) |
| 411 | Требуется длина | Требуется заголовок Content-Length |
| 413 | Содержимое слишком большое | Тело запроса превышает ограничения сервера |
| 414 | URI слишком длинный | URL превышает ограничения сервера |
| 415 | Неподдерживаемый тип медиа | Content-Type запроса не поддерживается |
| 418 | Я — чайник | Шуточный код RFC 2324, иногда используемый для отказа варить кофе |
| 422 | Необрабатываемое содержимое | Синтаксис в порядке, но семантика не проходит проверку (API это обожают) |
| 425 | Слишком рано | Сервер не желает обрабатывать, возможно, повторённый запрос |
| 429 | Слишком много запросов | Достигнут предел скорости — отступите, соблюдайте Retry-After |
| 500 | Внутренняя ошибка сервера | Общая ошибка на стороне сервера |
| 501 | Не реализовано | Сервер не поддерживает функциональность |
| 502 | Неправильный шлюз | Прокси/шлюз получил недопустимый ответ от вышестоящего сервера |
| 503 | Служба недоступна | Перегружен или отключён на обслуживание — часто временно, может содержать Retry-After |
| 504 | Время ожидания шлюза истекло | Время ожидания прокси/шлюза истекло при ожидании вышестоящего сервера |
| 505 | Версия HTTP не поддерживается | Версия HTTP в запросе не поддерживается |
О нас
Коды состояния — это одночисловое резюме сервера для каждого ответа, сгруппированное по классам: 1xx — информационные, 2xx — успех, 3xx — переадресация, 4xx — ошибся клиент, 5xx — ошибся сервер. Таблица даёт коды, с которыми работающие разработчики действительно сталкиваются, с нюансами, важными на практике: 401 означает «не аутентифицирован», несмотря на своё название, 403 — это отказ независимо от входа, 422 — ошибка проверки API, 429 требует отступления. Коды, не перечисленные здесь (длинный хвост 1xx и экспериментальные коды), достаточно редки, чтобы один только класс говорил вам, как с ними обращаться.
Часто задаваемые вопросы
В чём разница между 401 и 403?
401: мы не знаем, кто вы (выполните аутентификацию). 403: мы знаем, но вам всё равно нельзя.
302 или 307 для временного перенаправления?
307 сохраняет метод и тело; 302 исторически позволял клиентам переключать POST на GET. В новой работе следует использовать 307 (или 308 для постоянного).