Коды состояния ответа HTTP

Код состояния ответа HTTP показывает, был ли успешно выполнен определённый HTTP запрос.

Ответы сгруппированы в 5 классов, каждому классу выделен свой диапазон кодов:

1. Информационные ответы (100 – 199)
2. Успешные ответы (200 – 299)
3. Сообщения о перенаправлении (300 – 399)
4. Ошибки клиента (400 – 499)
5. Ошибки сервера (500 – 599)

Полный список кодов состояний

1. Информационные ответы

100: Continue
101: Switching Protocols
102: Processing
103: Early Hints

2. Успешные ответы

200: OK
201: Created
202: Accepted
203: Non Authoritative Information
204: No Content
205: Reset Content
206: Partial Content
207: Multi Status
208: Already Reported
226: IM Used

3. Сообщения о перенаправлении

300: Multiple Choices
301: Moved Permanently
302: Found
303: See Other
304: Not Modified
305: Use Proxy
306: Reserved
307: Temporary Redirect
308: Permanent Redirect

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

400: Bad Request
401: Unauthorized
402: Payment Required
403: Forbidden
404: Not Found
405: Method Not Allowed
406: Not Acceptable
407: Proxy Authentication Required
408: Request Timeout
409: Conflict
410: Gone
411: Length Required
412: Precondition Failed
413: Request Entity Too Large
414: Request URI Too Long
415: Unsupported Media Type
416: Requested Range Not Satisfiable
417: Expectation Failed
418: IM A Teapot
420: Enhance Your Calm
421: Misdirected Request
422: Unprocessable Entity
423: Locked
424: Failed Dependency
425: Too Early
426: Upgrade Required
428: Precondition Required
429: Too Many Requests
431: Request Header Fields Too Large
444: No Response
449: Retry With
450: Blocked by Windows Parental Controls
451: Unavailable For Legal Reasons
499: Client Closed Request

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

500: Internal Server Error
501: Not Implemented
502: Bad Gateway
503: Service Unavailable
504: Gateway Timeout
505: HTTP Version Not Supported
506: Variant Also Negotiates
507: Insufficient Storage
508: Loop Detected
509: Bandwidth Limit Exceeded
510: Not Extended
511: Network Authentication Required
598: Network Read Timeout Error
599: Network Connect Timeout Error

Как мы видим кодов состояний очень много, рассмотрим подробнее наиболее часто встречающиеся из них:

200: OK

Запрос успешно выполнен. Значение результата зависит от метода HTTP:

• GET: Ресурс был получен и передан в теле сообщения.
• HEAD: Ответ содержит заголовки, но тела сообщения нет.
• PUT или POST: Ресурс, описывающий результат действия, передан в теле сообщения.
• TRACE: Тело сообщения содержит сообщение запроса, полученное сервером.

201: Created

Запрос выполнен успешно, и в результате был создан новый ресурс. Обычно это ответ, отправляемый на запросы POST или PUT.

204: No Content

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

301: Moved Permanently

URL-адрес запрошенного ресурса был изменен навсегда. Новый URL-адрес указан в ответе.

302: Found

URI запрошенного ресурса был временно изменен. В будущем могут быть внесены дальнейшие изменения в URI. Следовательно, этот же URI должен использоваться клиентом в будущих запросах.

304: Not Modified

Этот код используется для целей кэширования. Он сообщает клиенту, что ответ не был изменен, поэтому клиент может продолжать использовать кэшированную версию ответа.

400: Bad Request

Сервер не может или не будет обрабатывать запрос из-за чего-то, что воспринимается как ошибка клиента (например, неправильный синтаксис, формат или маршрутизация запроса).

401: Unauthorized

Хотя стандарт HTTP определяет этот ответ как «неавторизованный», семантически он означает «неаутентифицированный». Это значит, что клиент должен аутентифицировать себя, чтобы получить запрошенный ответ.

403: Forbidden

Клиент не имеет прав доступа к контенту, то есть он неавторизован, поэтому сервер отказывается предоставить запрошенный ресурс. В отличие от 401 Unauthorized, личность клиента известна серверу.

404: Not Found

Сервер не может найти запрошенный ресурс. В браузере это означает, что URL-адрес не распознан. В API это также может означать, что адрес правильный, но ресурс не существует. Сервер также может отправить этот код ответа вместо 403 Forbidden, чтобы скрыть существование ресурса от неавторизованного клиента. Это самый известный код ответа из-за его частого появления в сети.

405: Method Not Allowed

Метод запроса известен серверу, но не поддерживается целевым ресурсом. Например, API может не разрешать вызов DELETE для удаления ресурса.

500: Internal Server Error

На сервере произошла ошибка, в результате которой он не может успешно обработать запрос.

503: Service Unavailable

Сервер не готов обработать запрос в данный момент. Распространёнными причинами являются техническое обслуживание или перегрузка сервера. Вместе с таким ответом следует отправлять удобную для пользователя страницу с объяснением проблемы, а также HTTP-заголовок Retry-After с расчётным временем решения проблемы. Кроме того, полезно отправлять заголовки с информацией о кешировании, поскольку эти временные ответы обычно не следует кэшировать.