Довідник кодів стану HTTP — безкоштовно

Використовується для запитів з Expect: 100-continue. Сервер підтверджує, що готовий отримати тіло до того, як клієнт його надішле. Рідко зустрічається в сучасних веб-додатках.

Найчастіше використовується для оновлення WebSocket — клієнт запитує Upgrade: websocket, а сервер відповідає 101 для перемикання.

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

Дозволяє серверам надсилати заголовки Link (preload/preconnect) доки остаточна відповідь ще готується, щоб браузери могли починати завантажувати критичні ресурси раніше.

Стандартна відповідь про успіх. Значення залежить від методу HTTP: GET → ресурс повернено, POST/PUT → дію завершено.

Поширено після POST. Відповідь повинна включати заголовок Location, що вказує на URL нового ресурсу.

Для асинхронних операцій — сервер ставить роботу в чергу. Клієнт повинен опитати точку статусу або повернутися пізніше.

Запит виконано успішно, але посередник (наприклад, кешувальний або перетворювальний проксі) змінив корисне навантаження, отримане від початкового сервера, — наприклад, повторно стиснув зображення. На практиці трапляється рідко.

Часто використовується для операцій DELETE або оновлень PUT, які не потребують повернення тіла. Клієнт не повинен залишати поточну сторінку.

Як і 204, тіло не повертається, але клієнту додатково вказується скинути форму або представлення, що ініціювало запит (наприклад, очистити поля форми для наступного запису).

Відповідь на запит Range. Використовується програвачами відео та менеджерами завантажень для відновлення перерваних завантажень або потокового передавання великих файлів.

WebDAV: тіло XML незалежно повідомляє результат кількох субоперацій — наприклад, пакетного переміщення, де одні елементи оброблено успішно, а інші — ні.

WebDAV: використовується у відповідях 207 Multi-Status, щоб уникнути повторного переліку елементів тієї самої колекції, коли прив’язки створюють цикли.

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

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

Використовується для постійних змін URL — пошукові системи оновлять свій індекс. SEO-авторитет переходить на новий URL.

Вказує, що перенаправлення не постійне. Кешування менш агресивне, ніж 301. Використовується для дій на кшталт «потрібна авторизація, перенаправляю на /login».

Використовується після надсилання POST — відповідь означає «ваш POST спрацював, результат дивіться за цим URL через GET». Браузери завжди роблять GET на новий URL.

Відповідь на умовний запит (з заголовками If-None-Match або If-Modified-Since). Економить смугу пропускання — тіло не повертається.

Якщо оригіналом був POST, перенаправлення також використовує POST. Сучасна альтернатива 302, коли збереження методу важливо.

Сучасна заміна 301, коли ви хочете, щоб запити POST залишалися POST після перенаправлення.

Поширені причини: неправильно сформований JSON у тілі, недійсні параметри запиту або відсутні обов'язкові поля. Перевірте тіло та заголовки запиту.

Клієнт повинен включити облікові дані аутентифікації (заголовок Authorization, файл cookie, токен). «Unauthorized» є неправильним — це означає «неавтентифікований».

Спочатку призначено для цифрових платежів. Сучасне використання: API іноді повертають 402, коли користувач перевищив свою платну квоту.

Відрізняється від 401 — користувач УВІЙШОВ у систему, але його обліковий запис не має дозволу для цього ресурсу. Перевірте логіку ролей/дозволів.

Або URL невірний, або ресурс видалено, або його ніколи не було. Сервери іноді повертають 404, щоб приховати, що 403 був би точніший.

Наприклад, запит GET до точки, яка приймає лише POST. Відповідь повинна включати заголовок Allow зі списком дійсних методів.

Клієнт запитав тип вмісту, мову або кодування (через Accept, Accept-Language, Accept-Encoding), які сервер не може надати. Багато серверів пропускають сувору перевірку узгодження і повертають типове значення.

Як 401, але виданий проксі: клієнт повинен надіслати облікові дані Proxy-Authorization. Видно в корпоративних мережах з автентифікуючими проксі.

Клієнт занадто довго відправляв тіло запиту або тримав з'єднання в неактивному стані. Спробуйте запит ще раз.

Зазвичай повертається при конфліктах одночасного редагування або дублювання ресурсу (наприклад, створення користувача з електронною адресою, яка вже існує).

Сильніше за 404 — сервер явно знає, що ресурс РАНІШЕ ІСНУВАВ, але був назавжди видалений. Пошукові системи видалять його з індексу.

Запит було відхилено, оскільки він не мав заголовка Content-Length, а сервер відмовляється від тіл невідомого розміру. Додайте заголовок і повторіть спробу.

Повертається, коли умовні заголовки, такі як If-Match або If-Unmodified-Since, не спрацьовують — зазвичай оптимістичне блокування: хтось інший змінив ресурс з часу вашої версії. Отримайте заново і повторіть спробу.

Поширене при завантаженні великих файлів. Конфігурація сервера (nginx, apache) встановлює максимальний розмір тіла. Перевірте конфігурацію сервера.

Зазвичай викликається дуже довгими рядками запиту (наприклад, кодування даних у GET). Перейдіть на тіло POST або збільште обмеження сервера, якщо ви його контролюєте.

Наприклад, відправлення application/xml на сервер, який приймає лише application/json. Встановіть правильно заголовок Content-Type.

Заголовок Range запитує частину, яка не існує у файлі — наприклад, відновлення завантаження після кінця файлу. Відповідь повинна містити Content-Range з фактичним розміром.

Надсилається, коли сервер не підтримує Expect: 100-continue. Деякі клієнти за замовчуванням надсилають цей заголовок при великих POST; його вимкнення зазвичай вирішує проблему.

Жарт Першого квітня 1998 року (RFC 2324). Деякі реальні API використовують його для жартів або позначення застарілих кінцевих точок. Не для виробничого використання.

Поширено при повторному використанні з'єднання HTTP/2: запит дійшов до сервера, який не налаштований для цього імені хосту. Клієнт повинен повторити спробу на новому з'єднанні.

Наприклад, JSON було коректно розібрано, але відсутнє обов'язкове поле або значення поля було за межами діапазону. Поширене у відповідях валідації REST API.

WebDAV: ресурс джерела або призначення заблоковано іншим клієнтом, тому операція не може продовжитися. Дочекайтеся звільнення блокування або розірвіть його з належним токеном.

WebDAV: у ланцюзі залежних операцій попередня дія не вдалася, тому ця не була виконана. Перегляньте попередню помилку, щоб знайти основну причину.

Пов'язано з TLS 1.3 0-RTT (ранні дані): сервер не ризикуватиме обробкою, можливо, відтворюваного запиту. Клієнт повинен повторити спробу після завершення квитування.

Сервер відмовляється обслуговувати запит через поточний протокол, але буде після оновлення — відповідь містить заголовок Upgrade, що називає потрібний протокол.

Сервер вимагає умовних заголовків (наприклад, If-Match), щоб запобігти конфліктам втраченого оновлення. Отримайте ресурс, запишіть його ETag і надішліть повторно з If-Match.

Уповільніть. Відповідь повинна містити заголовок Retry-After, що вказує, коли повторити спробу. Поширено для API, які мають квоти запитів.

Або один заголовок, або загальний розмір заголовка перевищує обмеження — найчастіше викликається надмірними файлами cookie. Очистіть файли cookie або зменшіть те, що ваша програма в них зберігає.

Ресурс заблоковано з юридичних причин — цензура, судові накази або регіональні нормативні акти. Число посилається на роман «Fahrenheit 451».

Універсальний код для помилок на стороні сервера. Перевірте журнали сервера щодо фактичної причини: необроблений виняток, помилка бази даних тощо.

Наприклад, сервер не розпізнає метод HTTP. Рідко на практиці — частіше ви побачите 405.

Поширено в архітектурах мікросервісів. Ваш балансувальник навантаження або зворотний проксі отримав некоректну відповідь від сервісу бекенду.

Або на обслуговуванні, або перевантажено. Відповідь повинна містити заголовок Retry-After. Часто повертається під час розгортань.

Сервіс бекенду не відповів достатньо швидко. Перевірте стан вищестоящого сервісу та конфігурацію тайм-аутів.

Основна версія HTTP запиту не підтримується сервером. Майже ніколи не зустрічається у сучасних клієнтів.

Прозоре узгодження вмісту зациклилося: вибраний варіант сам налаштований на узгодження. Указує на помилку в конфігурації сервера.

Спочатку для WebDAV, але іноді використовується загальними серверами. Означає, що сервер не може зберегти запит через обмеження зберігання.

WebDAV: обробка запиту Depth: infinity увійшла в цикл (наприклад, циклічні прив'язки). Операцію було припинено.

Із застарілої системи розширення HTTP: сервер потребує більше інформації, перш ніж він може виконати запит. Фактично не використовується у сучасному вебі.

Використовується порталами авторизації в мережі (WiFi готелів/аеропортів), щоб вказати, що користувач повинен увійти в мережу перед доступом до зовнішніх сайтів.