Довідник кодів стану HTTP

Знайдіть будь-який код стану HTTP — 200, 404, 500 і все, що між ними — з поясненням простою мовою, що він означає і коли сервери його повертають.

Що таке Довідник кодів стану HTTP?

Коди стану HTTP — це тризначні числа, які веб-сервер надсилає з кожною відповіддю, повідомляючи клієнту (браузеру, застосунку чи споживачу API), чи запит виконано успішно, чи потрібне перенаправлення, чи він зазнав невдачі — і чому. Вони стандартизовані IETF і використовуються однаково в кожному веб-сервері, браузері та мові програмування, що робить їх одним з найуніверсальніших довідників для налагодження в розробці ПЗ.

Цей довідник охоплює найпоширеніші коди з усіх п'яти категорій — інформаційні (1xx), успіх (2xx), перенаправлення (3xx), помилка клієнта (4xx) та помилка сервера (5xx) — з поясненнями простою мовою того, що кожен із них насправді означає на практиці, а не лише формальне визначення з RFC.

Формула

1xx: Інформаційні — запит отримано, обробка триває

2xx: Успіх — запит успішно отримано й прийнято

3xx: Перенаправлення — потрібна подальша дія для завершення запиту

4xx: Помилка клієнта — запит містить неправильний синтаксис або не може бути виконаний

5xx: Помилка сервера — сервер не зміг виконати коректний запит

Як розрахувати

Введіть код стану (наприклад, 404) або ключове слово (наприклад, "forbidden") у поле пошуку.
Фільтруйте за категорією за допомогою кнопок 1xx-5xx, якщо хочете переглянути конкретний діапазон.
Прочитайте опис простою мовою того, що означає код і коли його зазвичай повертають.
Використовуйте це як швидкий довідник під час налагодження відповідей API чи створення обробки помилок.

Приклад

Пошук "429" повертає "Too Many Requests" — код, який API повертають, коли ви перевищили ліміт запитів, повідомляючи вам сповільнитися та повторити спробу після затримки.

Ключові переваги

Усі поширені коди стану в одному довіднику з пошуком
Пояснення простою мовою, а не лише формальні формулювання RFC
Миттєве фільтрування за категорією (від 1xx до 5xx)
Безкоштовно, швидко, без реєстрації

Поширені помилки

Повертати 200 OK для запиту, який насправді завершився невдачею, приховуючи помилки від інструментів моніторингу
Плутати 401 (не автентифіковано) з 403 (автентифіковано, але немає прав)
Використовувати 302 для перенаправлення, яке має бути постійним (301), що шкодить SEO
Однаково обробляти всі помилки 4xx і 5xx на стороні клієнта замість розгалуження за конкретним кодом

Поради

Резервуйте коди 5xx суворо для помилок на боці сервера — ніколи не використовуйте їх для сигналізації про помилки вводу з боку клієнта
Використовуйте 429 із заголовком Retry-After при обмеженні швидкості запитів, щоб коректно налаштовані клієнти знали, коли повторити спробу
Віддавайте перевагу 404, а не загальній сторінці помилки, коли ресурс справді не існує — це краще і для користувачів, і для пошукових систем
Під час проєктування API обирайте конкретні коди 4xx (422, 409, 400), а не використовуйте за замовчуванням загальний 400

Ключові терміни

Рядок стану (Status line): перший рядок відповіді HTTP, що містить код стану та коротку фразу-пояснення
Ідемпотентність (Idempotent): властивість певних методів HTTP, за якої повторення того самого запиту дає той самий ефект, що й одноразове виконання
Ланцюжок перенаправлень (Redirect chain): послідовність кількох перенаправлень, які проходить браузер перед досягненням кінцевого ресурсу
Обмеження швидкості (Rate limiting): обмеження кількості запитів, які клієнт може зробити за певний проміжок часу, часто сигналізується кодом 429

Типові випадки використання

Швидке розуміння незнайомого коду стану, повернутого API, з яким ви інтегруєтеся
Вибір, який код стану повернути з власного API для певної умови помилки
Налагодження причини невдачі запиту шляхом перевірки того, що насправді означає конкретний код
Викладання чи вивчення основ HTTP на курсі з веброзробки
Написання точної логіки обробки помилок, що розрізняє різні випадки 4xx і 5xx

Часті запитання

Що означають різні діапазони кодів стану HTTP?

Коди 1xx — інформаційні, 2xx означають успіх, 3xx вказують на перенаправлення, 4xx означають, що клієнт допустив помилку (наприклад, запитав відсутню сторінку), а 5xx означають, що сам сервер не зміг виконати коректний запит.

У чому різниця між 401 і 403?

401 Unauthorized означає, що ви не пройшли автентифікацію (або ваші облікові дані недійсні) — сервер не знає, хто ви. 403 Forbidden означає, що сервер знає, хто ви, але у вас немає дозволу на доступ до ресурсу.

Чому я іноді бачу 200 для сторінки, яка явно не завантажилася?

Зазвичай це означає, що сервер повернув коректну HTTP-відповідь (звідси 200 OK), але вміст цієї відповіді на рівні застосунку описує помилку — поширений патерн у API, які розміщують деталі помилки в тілі відповіді, а не в коді стану.

У чому різниця між перенаправленнями 301 і 302?

301 Moved Permanently вказує браузерам і пошуковим системам оновити свої записи та надалі використовувати нову URL-адресу. 302 Found сигналізує про тимчасове перенаправлення — оригінальну адресу слід використовувати і для майбутніх запитів.