HTTP коди

HTTP коди стану (HTTP status codes) — це тризначні числові відповіді, які сервер надсилає у відповідь на HTTP-запит від клієнта (наприклад, браузера). Вони інформують клієнта про результат обробки запиту і дають зрозуміти, чи був він успішним, чи виникли проблеми.

1xx — Інформаційні відповіді

Ці коди інформують про те, що сервер прийняв запит і продовжує його обробку.

• 100 Continue — Сервер отримав початкову частину запиту і клієнт може продовжити його надсилання.
• 101 Switching Protocols — Сервер погоджується змінити протокол за запитом клієнта.
• 102 Processing — Запит отримано, але для його обробки потрібен час (використовується для WebDAV).
• 103 Early Hints — Дає змогу клієнту почати попередньо завантажувати ресурси до того, як отримає повну відповідь.

2xx — Успішні відповіді

Ця категорія вказує на те, що запит клієнта був успішно оброблений.

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

3xx — Перенаправлення

Ці коди вказують на те, що для завершення запиту потрібні додаткові дії, зазвичай пов’язані з переміщенням ресурсу.

• 300 Multiple Choices — Існує кілька варіантів для запиту, і клієнт повинен вибрати один.
• 301 Moved Permanently — Ресурс переміщено на новий постійний URL.
• 302 Found — Ресурс тимчасово переміщено на інший URL.
• 303 See Other — Ресурс можна знайти за іншою URL-адресою, використовуючи GET-запит.
• 304 Not Modified — Ресурс не змінювався з часу останнього запиту (використовується для кешування).
• 305 Use Proxy — Ресурс доступний тільки через проксі-сервер.
• 306 (Unused) — Код раніше використовувався, але більше не застосовується.
• 307 Temporary Redirect — Ресурс тимчасово переміщений, але метод запиту не змінюється.
• 308 Permanent Redirect — Ресурс переміщено постійно, і метод запиту повинен залишитися незмінним.

4xx — Клієнтські помилки

Ці коди вказують на те, що клієнт зробив помилку в запиті.

• 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 Payload Too Large — Розмір тіла запиту перевищує допустимі межі.
• 414 URI Too Long — URI запиту занадто довгий для обробки сервером.
• 415 Unsupported Media Type — Тип медіа-даних, переданих у запиті, не підтримується сервером.
• 416 Range Not Satisfiable — Вказаний діапазон в запиті неможливо виконати (наприклад, для часткових завантажень).
• 417 Expectation Failed — Сервер не може виконати умову, вказану в заголовку Expect.
• 418 I’m a teapot — Жартівливий код, запропонований у 1998 році (RFC 2324).
• 421 Misdirected Request — Запит був направлений на сервер, який не може його обробити.
• 422 Unprocessable Entity — Сервер не може обробити запит через семантичну помилку (WebDAV).
• 423 Locked — Доступ до ресурсу заблокований (WebDAV).
• 424 Failed Dependency — Операція не виконана через невиконану попередню операцію (WebDAV).
• 425 Too Early — Сервер отримав запит занадто рано (застосовується до транзакцій, що використовують TLS).
• 426 Upgrade Required — Клієнт повинен перейти на інший протокол.
• 428 Precondition Required — Сервер вимагає додаткових умов для виконання запиту.
• 429 Too Many Requests — Клієнт надіслав занадто багато запитів за короткий проміжок часу.
• 431 Request Header Fields Too Large — Поля заголовка запиту занадто великі для обробки сервером.
• 451 Unavailable For Legal Reasons — Доступ до ресурсу заблокований через юридичні причини (наприклад, через цензуру).

5xx — Серверні помилки

Ці коди означають, що сервер не зміг обробити коректний запит через внутрішню помилку.

• 500 Internal Server Error — Загальна помилка на стороні сервера.
• 501 Not Implemented — Сервер не підтримує функціонал, необхідний для виконання запиту.
• 502 Bad Gateway — Сервер отримав неправильну відповідь від іншого сервера при виконанні запиту.
• 503 Service Unavailable — Сервер тимчасово недоступний через перевантаження або технічні роботи.
• 504 Gateway Timeout — Сервер не отримав відповідь від іншого сервера вчасно.
• 505 HTTP Version Not Supported — Версія протоколу HTTP, використана в запиті, не підтримується сервером.
• 506 Variant Also Negotiates — Помилка в конфігурації серверних варіантів (неправильна конфігурація Content Negotiation).
• 507 Insufficient Storage — На сервері недостатньо місця для виконання запиту (WebDAV).
• 508 Loop Detected — Виявлено нескінченний цикл при обробці запиту (WebDAV).
• 510 Not Extended — Сервер вимагає подальших розширень для виконання запиту.
• 511 Network Authentication Required — Необхідна автентифікація в мережі (наприклад, для доступу через портал авторизації Wi-Fi).

Ці коди допомагають і клієнтам, і розробникам розуміти, що відбувається під час комунікації з сервером та як реагувати на можливі проблеми.