756 подписчиков

Путеводитель в мире HTTP: Все, что вам нужно знать о Статус-Кодах

26 февраля26 фев

6 мин

Когда мы взаимодействуем с интернетом, будь то просмотр веб-страниц или работа с API, мы постоянно сталкиваемся с понятием "HTTP статус-коды". Эти коды, вероятно, одна из самых важных частей всей архитектуры веб-взаимодействия. Понимание их может значительно облегчить работу любого разработчика, помогая диагностировать проблемы и оптимизировать пользовательский опыт. Давайте узнаем, что такое HTTP статус-коды и как они могут повлиять на ваши веб-приложения. При каждом HTTP-запросе сервер возвращает ответ, содержащий данные о выполнении запроса. Ключевой частью этого ответа является статус-код, который состоит из трех цифр и определяет результат запроса. Статус-коды сгруппированы по классам, указывающим тип результата взаимодействия: Рассмотрим пример HTTP-запроса и его возможного ответа: Запрос: POST /index.html HTTP/1.1

Host: antonkozlov.tilda.ws

Accept: image/gif, image/jpeg, */*

Accept-Encoding: gzip, deflate, br

Accept-Language: ru-RU,ru

User-Agent: Mozilla/5.0

text=PHP&mode=full Э

Host: antonkozlov.tilda.ws

Accept: image/gif, image/jpeg, */*

Accept-Encoding: gzip, deflate, br

Accept-Language: ru-RU,ru

User-Agent: Mozilla/5.0

text=PHP&mode=full Э

Оглавление

Что такое статус-коды HTTP?
Пример HTTP-запроса и ответа
Разбор основных категорий статус-кодов

Что такое статус-коды HTTP?

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

1xx — Informational (Информационные): Подсказывают клиенту, что запрос был принят, обработка продолжается. Используется довольно редко.
2xx — Success (Успех): Указывают, что запрос клиента был успешно принят, понятен и обработан.
3xx — Redirection (Перенаправление): Сообщают, что для выполнения запроса требуются дополнительные действия, часто использующие для перенаправления клиента.
4xx — Client Error (Ошибка клиента): Указывают на проблемы с запросом клиента, требующие коррекции со стороны клиента.
5xx — Server Error (Ошибка сервера): Говорят о проблемах на стороне сервера, мешающих работе с запросом.

Пример HTTP-запроса и ответа

Рассмотрим пример HTTP-запроса и его возможного ответа:

Запрос:

POST /index.html HTTP/1.1
Host: antonkozlov.tilda.ws
Accept: image/gif, image/jpeg, */*
Accept-Encoding: gzip, deflate, br
Accept-Language: ru-RU,ru
User-Agent: Mozilla/5.0
text=PHP&mode=full

Этот Post-запрос отправляет данные на сервер по адресу /index.html, указывая, что клиент предпочтет данные в формате изображений или других, сжатыми методами gzip, deflate или brotli и на русском языке.

Ответ:

HTTP/1.1 200 OK
Date: Tue, 31 Mar 2025 011:26:48 GMT
Content-Type: text/html; charset=utf-8
Server: nginx/1.16.1 (Ubuntu)
X-Powered-By: PHP/5.6.40

<h1>Main page</h1>

Сервер отвечает с кодом 200 OK, обозначающим успешное выполнение запроса, что подтверждается заголовками ответа и содержимым (заголовок страницы).

Разбор основных категорий статус-кодов

1xx — Informational (Информационные)

Эти коды редко видны пользователям и в основном уведомляют о процессе обработки запроса:

100 Continue: Клиент должен продолжить отправлять запрос.
101 Switching Protocols: Сервер меняет протоколы по запросу клиента.
102 Processing: Указывает, что запрос все еще обрабатывается.

2xx — Success (Успех)

Статус-коды этого класса сообщают, что запрос был успешно обработан:

200 OK: Запрос успешно выполнен и обработан, и сервер отправляет запрашиваемые данные.
201 Created: Новый ресурс был создан в результате выполнения POST-запроса. В результате такого запроса был создан ресурс, файл или запись в базе данных.
202 Accepted: Означает, что код запроса был принят в обработку, но клиенту не обязательно дожидаться его завершения.
203 Non-Authoritative Information: Означает, что содержимое ответа (тело) взято не с основного сервера, например, с резервного сервера.
204 No Content: Успех запроса (только заголовки), без содержимого документа.
206 Partial Content: Сервер успешно обработал GET-запрос на часть контента и успешно вернул часть сообщения. Используется, когда необходимо получить огромные массивы информации.
205 Reset Content: Редко используемый ответ от сервера.
207 Multi-Status: Редко используемый ответ от сервера.
208 Already Reported: Редко используемый ответ от сервера.
226 IM Used: Редко используемый ответ от сервера.

3xx — Redirection (Перенаправление)

Этот класс обозначает, что для завершения запроса требуются дополнительные действия:

301 Moved Permanently: Ресурс перемещен насовсем; все дальнейшие запросы должны идти на новый URI.
302 Found (Moved Temporarily): Временное перенаправление.
303 See Other: Клиент должен направить запрос к другому ресурсу обязательно методом GET.
304 Not Modified: Временное отсутствие изменения у запрашиваемого ресурса в течение определённого времени, который указал клиент в своём запросе. Ответ сервера содержит только заголовки. Этот статус-код перенаправляет Клиента к себе в кэш.
305 Use Proxy: Клиенту требуется для запроса ресурса использовать proxy сервер.
300 Multiple Choices: Редко используемый ответ от сервера.
307 Temporary Redirect: Редко используемый ответ от сервера.
308 Permanent Redirect: Редко используемый ответ от сервера.

4xx — Client Error (Ошибка клиента)

Коды ошибок клиента возникают, когда есть проблемы с запросом:

400 Bad Request: Запрос некорректен из-за синтаксической ошибки.
401 Unauthorized: Необходима авторизация на сервере.
403 Forbidden: Доступ запрещен из за закрытого ресурса, либо ввода неверного логина и пароля.
404 Not Found: Ресурс не найден на сервере.
405 Method Not Allowed: Используемый метод запроса не разрешён.
408 Request Timeout: Истекло время ожидания отправки клиентом запроса.
414 URI Too Long: Адрес запрашиваемого ресурса (URI) слишком длинный.
429 Too Many Requests: Клиент сделал слишком много запросов за короткий период конкретного ресурса, либо сервера целиком. Сервер в данном случае блокирует очередной запрос. Это способ защиты серверов от хакерских атак.

Редко используемые коды ошибок:

406 Not Acceptable
407 Proxy Authentication Required
409 Conflict
410 Gone
411 Length Required
412 Precondition Failed
413 Payload Too Large
415 Unsupported Media Type
416 Range Not Satisfiable
417 Expectation Failed
419 Authentication Timeout
421 Misdirected Request
422 Unprocessable Entity
423 Locked
424 Failed Dependency
426 Upgrade Required
428 Precondition Required
429 Too Many Requests
431 Request Header Fields Too Large
434 Requested host unavailable
449 Retry With
451 Unavailable For Legal Reasons
499 Client Closed Request

5xx — Server Error (Ошибка сервера)

Эти коды указывают на неправильную работу сервера при обработке запроса:

500 Internal Server Error: Внутренняя ошибка сервера без указания детали. Сервер имеет ошибку в программном коде.
502 Bad Gateway: Неверный ответ со стороны промежуточного сервера.
503 Service Unavailable: Временная недоступность сервиса из-за огромного количества запросов к нему и перегруженности.
504 Gateway Timeout: Прокси сервер не дождался ответа от основного сервера, который он проксирует.

Редко используемые коды ошибок:

501 Not Implemented
505 HTTP Version Not Supported
506 Variant Also Negotiates
507 Insufficient Storage
509 Bandwidth Limit Exceeded
510 Not Extended
511 Network Authentication Required
...

Заключение

Статус-коды HTTP играют решающую роль в интернет-взаимодействиях, предоставляя как разработчикам, так и конечным пользователям ценную информацию о выполнении запросов. Понимание их значений помогает сократить время диагностики проблем, оптимизировать процессы и улучшить взаимодействие пользователей с веб-приложениями. Независимо от того, работаете ли вы с веб-браузерами или создаете API. Освоение этих кодов — важный шаг на пути к созданию эффективных веб-решений.