Все утилиты

HTTP-коды

Справочник распространённых HTTP-кодов.

1xx Информационные

100

Continue

Сервер получил заголовки запроса, клиент может продолжить отправку тела. Позволяет не передавать большой payload, если запрос могут отклонить.

101

Switching Protocols

Сервер согласен сменить протокол (например, с HTTP на WebSocket) по заголовку Upgrade.

102

Processing

Запрос принят и обрабатывается, но тело ответа пока недоступно. Используется при долгих операциях.

2xx Успех

200

OK

Запрос выполнен успешно. В теле ответа обычно возвращается запрошенный ресурс или результат операции.

201

Created

Ресурс успешно создан. Часто после POST с заголовком Location, указывающим на новый объект.

202

Accepted

Запрос принят к обработке, но ещё не завершён. Типично для асинхронных задач и фоновых job.

204

No Content

Запрос успешен, но тело ответа пустое. Часто при успешном DELETE или PUT без возврата данных.

3xx Перенаправление

301

Moved Permanently

Ресурс навсегда перемещён на новый URL. Клиенты и поисковики должны обновить ссылки.

302

Found

Ресурс временно доступен по другому URL. В будущем можно снова обращаться к исходному адресу.

303

See Other

После POST клиенту следует получить результат через GET по URL из заголовка Location.

304

Not Modified

Кэшированная версия актуальна. Тело ответа не передаётся — используйте локальный кэш.

307

Temporary Redirect

Временный редирект с сохранением исходного HTTP-метода. POST остаётся POST, в отличие от старого поведения 302.

308

Permanent Redirect

Постоянный редирект с сохранением метода. Клиент должен использовать новый URL в дальнейшем.

4xx Ошибка клиента

400

Bad Request

Сервер не может обработать запрос из-за неверного синтаксиса, пропущенных полей или битого JSON. Исправьте запрос и повторите.

401

Unauthorized

Требуется аутентификация или она не прошла. Нужны корректные учётные данные, часто в заголовке Authorization.

403

Forbidden

Сервер понял запрос, но отказывает в доступе. Пользователь может быть авторизован, но без прав на действие.

404

Not Found

URL или ресурс не найден. Проверьте путь, маршрут или ID — объект мог быть удалён.

405

Method Not Allowed

HTTP-метод не разрешён для этого endpoint. Например, POST туда, где поддерживается только GET.

408

Request Timeout

Сервер не дождался полного запроса. Часто из-за медленной загрузки или простоя соединения.

409

Conflict

Запрос конфликтует с текущим состоянием ресурса. Типично при дубликатах или нарушении версионности.

410

Gone

Ресурс существовал, но удалён навсегда и больше не будет доступен. Сильнее, чем 404, для удалённого контента.

413

Payload Too Large

Тело запроса больше допустимого лимита сервера. Уменьшите размер или используйте chunked upload.

414

URI Too Long

URL превышает лимит сервера. Сократите query string или перенесите данные в тело запроса.

415

Unsupported Media Type

Сервер не поддерживает указанный Content-Type. Отправьте JSON, form-data или формат, который принимает API.

418

I'm a teapot

Шутка из RFC 2324: сервер-чайник отказывается варить кофе. Иногда встречается в демо и пасхалках.

422

Unprocessable Entity

Запрос синтаксически верен, но семантически неверен. Типично для ошибок валидации в REST API и формах.

429

Too Many Requests

Слишком много запросов за период. Учитывайте Retry-After, делайте backoff и rate limiting на клиенте.

5xx Ошибка сервера

500

Internal Server Error

Неожиданная ошибка на сервере. Обычно не вина клиента — смотрите логи и повторите позже.

501

Not Implemented

Сервер не поддерживает функциональность для выполнения запроса. Метод или возможность не реализованы.

502

Bad Gateway

Шлюз или прокси получил невалидный ответ от upstream. Часто за балансировщиком при падении backend.

503

Service Unavailable

Сервер временно недоступен — обслуживание или перегрузка. Повторите позже; проверьте Retry-After.

504

Gateway Timeout

Шлюз не дождался ответа от upstream. Указывает на медленный backend или сетевые проблемы.

32 распространённых HTTP-кодов

О инструменте

Используйте HTTP status reference как удобный справочник по кодам ответов для разработки и отладки API. Он объясняет классы статусов и частые пограничные сценарии от информационных до серверных ошибок.

Команды применяют его, чтобы синхронизировать поведение backend, frontend и мониторинга на единых правилах. Корректное использование статус-кодов улучшает наблюдаемость и стабильность интеграций.

Частые вопросы

Зачем нужен справочник HTTP статусов при разработке?
Он помогает выбирать правильные коды ответов, чтобы клиенты предсказуемо обрабатывали успех и ошибки.
Чем отличаются 4xx и 5xx статусы?
Коды 4xx обычно указывают на проблему в запросе клиента, а 5xx на сбой или недоступность на стороне сервера.
Полезно ли это для настройки мониторинга API?
Да, понимание семантики кодов помогает точнее настраивать алерты и быстрее разбирать инциденты.