Коди стану HTTP — це тризначні сигнали у відповіді сервера. Перша цифра позначає загальний результат, а дві наступні — конкретну умову. У цьому посібнику наведено зареєстровані стандартні коди з практичними поясненнями, а також відомі специфічні для постачальників значення, які можуть траплятися в журналах.
Коди стану HTTP є частиною протоколу HTTP, а не функцією браузера, яку кожен постачальник реалізує як окремий вебінтерфейс. Сучасні браузери обробляють стандартні класи відповідей; вигляд сторінок помилок і поведінка повторних спроб залежать від браузера. Підтримка нових проміжних відповідей і спеціалізованих розширень може відрізнятися залежно від версії та мережевого маршруту.
| Клас відповіді | Chrome / Edge | Firefox | Safari | Opera | Android / iOS WebView | Примітка щодо сумісності |
|---|---|---|---|---|---|---|
| Інформаційні відповіді 1xx | Підтримуються як проміжні відповіді протоколу | Підтримуються як проміжні відповіді протоколу | Підтримуються як проміжні відповіді протоколу | Підтримуються як проміжні відповіді протоколу | Підтримуються мережевим стеком платформи | Коди 100/101 усталені; 102 використовується рідко або застарів. Поширеність 103 Early Hints і помітність попереднього завантаження залежать від версії браузера, сервера та проміжних вузлів. |
| Успішні відповіді 2xx | Підтримується | Підтримується | Підтримується | Підтримується | Підтримується | Загальна семантика успішних відповідей є стандартною. Водночас важливі правила щодо тіла: наприклад, відповіді 204 і 205 не містять тіла. |
| Перенаправлення 3xx | Підтримується | Підтримується | Підтримується | Підтримується | Підтримується | На навігацію впливають Location, метод, кешування та політика безпеки. Коди 301/302 можуть змінити POST на GET; 307/308 зберігають метод. |
| Помилки клієнта або запиту 4xx | Підтримується | Підтримується | Підтримується | Підтримується | Підтримується | Браузер отримує відповідь, але те, чи покаже він тіло від сервера або власне сторінку помилки, залежить від коду стану та продукту. |
| Помилки сервера 5xx | Підтримується | Підтримується | Підтримується | Підтримується | Підтримується | Клієнти можуть обробляти цей клас відповіді, але створені проксі сторінки, повторні спроби та засоби діагностики відрізняються в різних браузерах. |
| Невідомий код відомого класу | Обробка на рівні класу | Обробка на рівні класу | Обробка на рівні класу | Обробка на рівні класу | Обробка на рівні класу | Клієнти HTTP можуть визначити загальний клас за першою цифрою; не покладайтеся на власний код як на такий, що має стандартну семантику чи однакове відображення в інтерфейсі. |
Тут сумісність описує обробку на рівні протоколу, а не гарантує, що всі браузери покажуть однакову сторінку помилки. Старі клієнти, вбудовані WebView, проксі та портали авторизації можуть мати додаткові обмеження.
Сервер прийняв заголовки запиту й очікує на решту тіла запиту. Код часто використовують із заголовком Expect: 100-continue, щоб клієнт міг не завантажувати великий обсяг даних, якщо запит буде відхилено.
Практичні рекомендації: Проміжна відповідь; продовжуйте надсилати тіло лише тоді, коли воно очікується.
Сервер погоджується змінити протокол цього з’єднання після запиту клієнта на оновлення. Типовий приклад — узгодження WebSocket.
Практичні рекомендації: Перехід на рівні з’єднання; перевірте заголовки Upgrade та Connection.
Сервер WebDAV повідомляє, що тривала операція розпочалася, але ще не завершилася. Це застаріла відповідь, яку не слід плутати з кінцевим результатом.
Практичні рекомендації: Проміжний статус WebDAV; дочекайтеся кінцевої відповіді.
Під час підготовки кінцевої відповіді сервер надсилає попередні заголовки, часто підказки Link. Клієнт може заздалегідь почати завантаження ймовірно важливих ресурсів.
Практичні рекомендації: Проміжна оптимізація; після неї має надійти кінцева відповідь.
Запит виконано успішно. Представлення залежить від методу: GET повертає ресурс, HEAD — метадані без тіла, а операція запису може повернути представлення результату.
Практичні рекомендації: Використовуйте для завершеного запиту з представленням відповіді, якщо воно доречне.
Запит завершився та створив один або кілька ресурсів. У відповіді слід указати новий ресурс, зазвичай за допомогою Location, і за потреби повернути його представлення.
Практичні рекомендації: Типовий результат POST або PUT; переконайтеся, що створений ресурс можна знайти.
Сервер прийняв запит на обробку, але вона ще не завершилася й може завершитися невдало. HTTP не надсилає пізніше другу відповідь для того самого обміну.
Практичні рекомендації: Надайте URL-адресу операції або її стану чи інший спосіб дізнатися кінцевий результат.
Проксі або проміжний вузол, що змінює дані, повернув метадані чи вміст, відмінні від відповіді джерела. Це означає, що відповідь не є безпосереднім авторитетним представленням ресурсу.
Практичні рекомендації: Використовуйте лише тоді, коли важливо позначити зміну відповіді проміжним вузлом.
Запит виконано успішно, і вміст відповіді відсутній. Заголовки все одно можуть містити корисні метадані, наприклад оновлені валідатори.
Практичні рекомендації: Не додавайте тіло відповіді.
Запит виконано успішно; клієнту пропонується скинути подання або форму, з якої його надіслано. Тіло відповіді не передається.
Практичні рекомендації: Корисно для дій, після яких слід очистити або скинути поточні поля введення.
Сервер виконав коректний запит діапазону й повертає лише запитані діапазони байтів. Заголовок Content-Range описує передані дані.
Практичні рекомендації: Переконайтеся, що значення Range і Content-Range узгоджені; цей код часто використовують для відновлення завантаження медіа й файлів.
Відповідь WebDAV повідомляє окремі результати для кількох ресурсів або підоперацій, зазвичай у структурованому тілі XML.
Практичні рекомендації: Інтерпретуйте результат для кожного вкладеного ресурсу: зовнішній код стану не описує результат повністю.
Багатостатусна відповідь WebDAV не містить елементів, які вже наведено в цій самій відповіді, щоб уникнути повторення.
Практичні рекомендації: Специфічний для WebDAV код; розглядайте його в контексті решти багатостатусної відповіді.
Сервер виконав GET із застосуванням маніпуляцій екземпляра й повернув представлення, сформоване на основі поточного ресурсу відповідно до узгодженого механізму різницевого кодування.
Практичні рекомендації: Спеціалізоване різницеве кодування; клієнт і сервер мають узгодити перетворення.
Для цільового ресурсу існує кілька представлень або місць розташування, і відповідь пропонує вибір. Клієнт або користувач може вибрати потрібний варіант.
Практичні рекомендації: Надайте зрозумілі альтернативи; не припускайте, що кожен клієнт автоматично зробить вибір.
Ресурс має постійно новий URI. Клієнти можуть оновити збережені посилання й кеш, тому використовуйте цей код лише для перенесення, яке має залишатися постійним.
Практичні рекомендації: Під час SEO-перенесення перенаправляйте безпосередньо на кінцеву еквівалентну URL-адресу й оновіть внутрішні посилання.
Ресурс тимчасово доступний за іншим URI. Історична поведінка допускає зміну методу в деяких випадках, тому цей код не найкращий вибір, якщо POST має залишатися POST.
Практичні рекомендації: Використовуйте для тимчасового переміщення, коли зміна методу прийнятна; якщо ні, розгляньте код 307.
Клієнт має отримати ресурс, зазначений у Location, методом GET (або HEAD, якщо доречно), а не повторювати початкову дію. Код часто використовують після надсилання форми.
Практичні рекомендації: Реалізує схему Post/Redirect/Get і запобігає повторному надсиланню дії.
Умовний запит GET або HEAD указує, що кешоване представлення досі актуальне. Відповідь не має тіла й дає змогу клієнту використати збережену копію.
Практичні рекомендації: Повертайте цей код лише тоді, коли валідатор, наприклад If-None-Match або If-Modified-Since, збігається.
Історична відповідь пропонувала клієнту отримати ресурс через проксі. Її скасовано з міркувань безпеки, тож сучасним сервісам не слід її використовувати.
Практичні рекомендації: Не використовуйте цей код; налаштовуйте проксі окремо від протоколу.
Це значення зарезервоване або не використовується в сучасних специфікаціях HTTP. Для поточних вебзастосунків воно не має стандартного практичного значення.
Практичні рекомендації: Не надсилайте цей код.
Ресурс тимчасово розміщено за іншим URI; під час переходу клієнт має зберегти початковий метод і тіло запиту.
Практичні рекомендації: Використовуйте, коли тимчасове переміщення не повинно перетворювати POST на GET.
Ресурс переміщено назавжди; під час переходу клієнт має зберегти початковий метод і тіло запиту.
Практичні рекомендації: Використовуйте для постійного переміщення, коли важливо зберегти метод; оновіть канонічні URL-адреси й внутрішні посилання.
Сервер не може обробити запит через некоректний синтаксис, форматування або надані дані. Повторне надсилання того самого запиту без змін навряд чи допоможе.
Практичні рекомендації: Перевірте кодування URL-адреси, синтаксис JSON або тіла запиту, обов’язкові поля та форматування запиту.
У запиті немає дійсних облікових даних для автентифікації на цільовому ресурсі. Попри назву, відповідь означає, що автентифікація потрібна або не пройшла.
Практичні рекомендації: Надайте очікувані облікові дані та додайте виклик автентифікації WWW-Authenticate.
Код зарезервовано для майбутнього використання, хоча деякі продукти застосовують його для оплати або квот. Єдиної сумісної між системами поведінки для оплати не визначено.
Практичні рекомендації: Вважайте значення, визначені постачальником, специфічними для нього; документуйте контракт API.
Сервер зрозумів запит, але відмовляється його виконувати. Дійсні облікові дані не обов’язково змінять результат, оскільки обмеження може бути встановлене політикою.
Практичні рекомендації: Перевірте дозволи, політику доступу, правила IP/WAF та авторизацію на рівні ресурсу.
Сервер не може знайти поточне представлення для запитаного URI або не бажає підтверджувати його наявність. Сама відповідь не повідомляє, чи відсутність тимчасова або постійна.
Практичні рекомендації: Виправте URL-адресу, відновіть ресурс або використайте код 410, якщо відомо, що його видалено назавжди.
Ресурс існує, але не підтримує метод, використаний у цьому запиті.
Практичні рекомендації: Поверніть заголовок Allow зі списком методів, які приймає ресурс.
Сервер не може створити представлення, що відповідає пріоритетам Accept, які клієнт указав у запиті.
Практичні рекомендації: Послабте обмеження Accept або налаштуйте відповідне представлення чи політику узгодження вмісту.
Проміжний проксі вимагає облікові дані, перш ніж передати запит далі.
Практичні рекомендації: Автентифікуйтеся на проксі за допомогою Proxy-Authenticate / Proxy-Authorization; це відрізняється від автентифікації на вихідному сервері.
Сервер не отримав повний запит протягом часу очікування, який він установив. Клієнт може повторити запит через нове з’єднання.
Практичні рекомендації: Перевірте перебої мережі, розмір завантаження та налаштування часу очікування сервера або проксі.
Запит конфліктує з поточним станом ресурсу, наприклад через розбіжність версій або спробу створити дублікат.
Практичні рекомендації: Поясніть причину конфлікту й надайте клієнту достатньо відомостей про поточний стан, щоб його усунути.
Ресурс навмисно й, імовірно, назавжди недоступний; відомої заміни немає. Це конкретніше, ніж загальна відповідь «не знайдено».
Практичні рекомендації: Використовуйте, якщо ресурс навмисно видалено; приберіть застарілі внутрішні посилання та згадки.
Сервер вимагає заголовок Content-Length, але запит його не містив.
Практичні рекомендації: Надішліть точне значення Content-Length або використайте підтримуваний спосіб передавання даних.
Умова запиту, наприклад If-Match, виявилася хибною, тому сервер не виконав запитану дію.
Практичні рекомендації: Оновіть представлення й повторіть запит із актуальними валідаторами або станом.
Тіло запиту перевищує обмеження, яке сервер може або готовий обробити. Сервер може закрити з’єднання або дозволити повторну спробу після зменшення обсягу даних.
Практичні рекомендації: Зменште обсяг даних або змініть задокументовані обмеження завантаження.
Ціль запиту задовга для обробки сервером; часто це пов’язано з надмірно довгим рядком параметрів запиту.
Практичні рекомендації: Скоротіть URI або перенесіть відповідні дані до тіла запиту.
Сервер відхиляє тіло запиту, оскільки не підтримує його тип даних, кодування вмісту або формат.
Практичні рекомендації: Надішліть підтримувані Content-Type і кодування, а також відповідне їм тіло запиту.
Запитаний діапазон байтів неможливо надати, наприклад, якщо він починається за межами довжини представлення.
Практичні рекомендації: Перевірте довжину ресурсу й одиниці діапазону; сервер може повернути Content-Range: bytes */length.
Сервер або проміжний вузол не може виконати очікування, зазначене в заголовку Expect.
Практичні рекомендації: Якщо це безпечно й доречно, повторіть запит без непідтримуваного очікування.
Жартівливий код стану зі специфікації до Дня сміху. Це не звичайний контракт помилки застосунку, хоча деякі сервіси використовують його для жарту.
Практичні рекомендації: Не покладайтеся на нього в сумісній із різними системами виробничій поведінці.
Запит надійшов на сервер, який не може сформувати авторитетну відповідь для цільового URI; часто причина полягає в невідповідності маршрутизації з’єднання або повноваження HTTP.
Практичні рекомендації: Повторіть запит через відповідне з’єднання та перевірте Host/:authority, SNI і маршрутизацію проксі.
Тип і синтаксис вмісту розпізнано, але сервер не може виконати інструкції або перевірити надіслані дані.
Практичні рекомендації: Надавайте практичні пояснення помилок перевірки окремих полів; виправлення даних може дати змогу виконати запит.
Ресурс WebDAV заблоковано, тому запитаний метод не можна виконати, доки не буде усунуто причину блокування.
Практичні рекомендації: Перевірте власника блокування, час його дії та обробку маркера блокування WebDAV.
Операція WebDAV завершилася невдало, оскільки не виконалася необхідна попередня операція в тій самій послідовності запиту.
Практичні рекомендації: Усуньте помилку попередньої дії, перш ніж повторювати залежні операції.
Сервер відмовляється обробляти запит, який могли повторно надіслати в ранніх даних, щоб зменшити ризик відтворення запиту.
Практичні рекомендації: Повторіть запит після встановлення з’єднання, не надсилаючи ранніх даних.
Сервер відмовляється від поточного протоколу та повідомляє, що клієнту слід перейти на інший.
Практичні рекомендації: Додайте заголовок Upgrade із переліком підтримуваних протоколів.
Сервер вимагає умовний запит, щоб запобігти втраті оновлень, але клієнт надіслав безумовний запит.
Практичні рекомендації: Отримайте поточний стан і надішліть відповідну умову, наприклад If-Match.
За визначений сервером період клієнт надіслав надто багато запитів і перевищив обмеження частоти.
Практичні рекомендації: Зменште частоту запитів, дотримуйтеся Retry-After, якщо він наявний, і уникайте одночасних повторних спроб великої кількості клієнтів.
Сервер не оброблятиме запит, оскільки одне чи кілька полів заголовка або весь набір заголовків завеликі.
Практичні рекомендації: Зменште обсяг файлів cookie або власних заголовків чи змініть навмисно встановлене обмеження сервера.
Сервер не може надати запитаний ресурс через юридичне обмеження.
Практичні рекомендації: За потреби поясніть причину й межі обмеження, не розкриваючи захищених відомостей.
На сервері виникла неочікувана ситуація, через яку запит не вдалося завершити. Це загальна відповідь на випадок, коли немає точнішої помилки сервера.
Практичні рекомендації: Зіставте запит із журналами сервера й не показуйте відвідувачам трасування стека.
Сервер не підтримує функцію, необхідну для виконання запиту; зазвичай ідеться про нереалізований метод або можливість.
Практичні рекомендації: Реалізуйте потрібну функцію або використайте підтримуваний метод; цей код не призначено для тимчасового перевантаження.
Сервер, що працює як шлюз або проксі, отримав некоректну відповідь від сервера вище за ланцюжком.
Практичні рекомендації: Перевірте стан сервера вище за ланцюжком, налаштування протоколу й TLS, DNS та журнали проксі.
Сервер тимчасово не може обробити запит, часто через технічне обслуговування або перевантаження.
Практичні рекомендації: За можливості вкажіть Retry-After, надайте зрозумілу відповідь і встановіть правила кешування, придатні для тимчасової помилки.
Шлюз або проксі не отримав своєчасної відповіді від сервісу вище за ланцюжком.
Практичні рекомендації: Перевірте затримку сервісу вище за ланцюжком, мережевий маршрут і бюджети часу очікування на всіх його ділянках.
Сервер не підтримує основну версію HTTP, використану в запиті.
Практичні рекомендації: Використовуйте підтримувану версію протоколу або оновіть налаштування сервера чи проксі.
Помилка конфігурації сервера створила циклічне узгодження вмісту: вибраний варіант знову запускає узгодження.
Практичні рекомендації: Виправте конфігурацію варіантів або узгодження вмісту; помилка виникла на вихідному сервері.
Сервер WebDAV не може зберегти представлення, необхідне для завершення операції.
Практичні рекомендації: Звільніть або збільште обсяг сховища й перевірте квоти, перш ніж повторювати запит.
Під час обробки запиту сервер виявив нескінченний цикл, часто під час обходу прив’язок WebDAV.
Практичні рекомендації: Усуньте циклічний зв’язок між ресурсами або правило обробки, що його спричинило.
Для запиту потрібне розширення, яке сервер не підтримує.
Практичні рекомендації: Використайте підтримуваний набір розширень або узгодьте альтернативу.
Щоб отримати доступ до мережі, клієнт має пройти автентифікацію, зазвичай через портал авторизації. Код призначений для мережевих проміжних вузлів, а не для входу на вебсайт.
Практичні рекомендації: Пройдіть автентифікацію для доступу до мережі, а потім повторіть початковий запит.
Ці значення трапляються в окремих продуктах, журналах серверів, CDN або застосунках. Вони не мають того самого значення, що й зареєстровані стандартні коди; звіряйтеся з документацією сервісу, який їх сформував.
Деякі застосунки використовують цю назву, коли завершується сеанс автентифікації. Це не універсально визначений статус HTTP, тому клієнти не можуть покладатися на узгоджене значення.
Практичні рекомендації: Повторно пройдіть автентифікацію згідно з умовами сервісу.
Відповідь окремих постачальників, яку історично використовували для обмеження частоти запитів. Її значення залежить від реалізації.
Практичні рекомендації: Дотримуйтеся задокументованих рекомендацій щодо обмеження запитів.
Деякі сервери закривають з’єднання без звичайної відповіді, часто для фільтрації запитів.
Практичні рекомендації: Перевірте журнали постачальника; замість показу цього коду клієнт може повідомити про помилку мережі.
Розширення Microsoft, яке деякі сервіси використовують, щоб попросити клієнта повторити запит із додатковими даними.
Практичні рекомендації: Дотримуйтеся документації відповідного API.
Зворотний проксі може записати цей статус у журнал, коли клієнт розриває з’єднання до завершення відповіді сервера. Зазвичай це класифікація в журналі, а не відповідь, доставлена клієнту.
Практичні рекомендації: Перевірте скасування запитів клієнтами й повільні відповіді серверів.
Деякі хостингові платформи використовують цей код для квоти або обмеження трафіку. Це не загальне взаємно сумісне значення HTTP.
Практичні рекомендації: Перевірте квоту хостингу та налаштування оплати.
CDN або проксі може повернути його, отримавши неочікувану або порожню відповідь від вихідного сервера.
Практичні рекомендації: Порівняйте журнали периферійного й вихідного вузлів; перевірте, чи надсилає вихідний сервер коректну відповідь HTTP.
Проксі не зміг установити з’єднання з вихідним сервером або той відхилив з’єднання.
Практичні рекомендації: Перевірте доступність вихідного сервера, правила брандмауера та списки дозволених адрес проксі.
Периферійний сервіс підключився або намагався підключитися до вихідного сервера, але не завершив обмін до спливу часу очікування.
Практичні рекомендації: Перевірте швидкість відповіді вихідного сервера та затримку мережі.
Проксі не зміг підключитися до налаштованої адреси вихідного сервера.
Практичні рекомендації: Перевірте DNS, маршрутизацію та IP-адресу вихідного сервера.
З’єднання з вихідним сервером установлено, але він не надіслав відповідь HTTP вчасно.
Практичні рекомендації: Скоротіть час обробки на вихідному сервері або змініть підтримувані налаштування часу очікування.
Проксі не зміг завершити узгодження TLS із вихідним сервером.
Практичні рекомендації: Перевірте сертифікати, сумісність протоколів і шифрів та SNI.
Проміжний вузол відхилив сертифікат вихідного сервера під час перевірки.
Практичні рекомендації: Установіть дійсний довірений сертифікат із правильним доменним ім’ям, чинним строком дії та повним ланцюжком.
Застарілий статус проксі або окремого постачальника, що повідомляє про збій з’єднання для прискорення вихідного сервера.
Практичні рекомендації: Перевірте конектор постачальника та маршрут до вихідного сервера.
Деякі клієнти або проксі використовують це значення для позначення перевищення часу читання з мережі. Воно не має універсального значення в HTTP.
Практичні рекомендації: Перевірте діагностичні дані клієнта або проксі.
Деякі проксі використовують це значення, коли спливає час очікування спроби мережевого з’єднання. Його значення залежить від реалізації.
Практичні рекомендації: Перевірте доступність вузла та налаштування часу очікування.
Для постійної зміни URL використовуйте постійне перенаправлення лише тоді, коли цільова адреса має замінити стару; для тимчасової зміни виберіть тимчасову відповідь. Скорочуйте ланцюжки й перенаправляйте безпосередньо на кінцеву еквівалентну сторінку. Переконайтеся, що кожне значення Location працює, кінцева відповідь доречна, а канонічні теги й внутрішні посилання узгоджені з потрібною URL-адресою. Кінцева відповідь 2xx підтверджує успішний HTTP-запит, але не засвідчує, що сторінка корисна, індексується або технічно справна.
На цій сторінці узагальнено семантику кодів стану HTTP для практичного використання. Реєстр стандартів і RFC є авторитетними джерелами стандартизованих кодів; MDN пропонує доступний технічний посібник, а Вікіпедія — допоміжний огляд, який редагує спільнота.