Що таке Довідник кодів стану HTTP?
Коди стану HTTP — це тризначні числа, які вебсервер надсилає з кожною відповіддю, повідомляючи клієнтові (браузеру, застосунку або споживачеві API), чи успішним був запит, чи потребує перенаправлення, чи завершився помилкою — і чому. Вони стандартизовані організацією IETF і однаково використовуються в усіх вебсерверах, браузерах і мовах програмування, що робить їх одним із найуніверсальніших довідників для налагодження в розробці програмного забезпечення.
Цей інструмент пошуку охоплює найпоширеніші коди з усіх п'яти категорій — інформаційні (1xx), успіх (2xx), перенаправлення (3xx), помилки клієнта (4xx) і помилки сервера (5xx) — із простими поясненнями, що кожен із них насправді означає на практиці, а не лише формальним визначенням з RFC.
Коли використовувати цей калькулятор
- Налагодження інтеграції API, коли запит не виконується і потрібно зрозуміти, що насправді означає код стану
- Вирішення, який код стану HTTP повертати з власного API для конкретної умови помилки
- Викладання або вивчення основ HTTP на курсі чи в буткемпі з веброзробки
- Написання проміжного програмного забезпечення обробки помилок, яке має розрізняти різні випадки 4xx і 5xx
- З'ясування, чому перенаправлення не працює, перевіряючи, чи повернуто 301, чи 302
- Усунення проблем із CORS, коли браузер показує мережеву помилку, а сервер повернув 200
Кроки:
- Введіть код стану (наприклад, 404) або ключове слово (наприклад, "forbidden") у поле пошуку.
- Відфільтруйте за категорією за допомогою кнопок 1xx-5xx, якщо хочете переглянути конкретний діапазон.
- Прочитайте просте пояснення того, що означає код і коли його зазвичай повертають.
- Використовуйте це як швидкий довідник під час налагодження відповідей API або створення обробки помилок.
Формула
1xx: Інформаційні — запит отримано, процес триває
2xx: Успіх — запит успішно отримано та прийнято
3xx: Перенаправлення — потрібні подальші дії для завершення запиту
4xx: Помилка клієнта — запит містить неправильний синтаксис або не може бути виконаний
5xx: Помилка сервера — сервер не зміг виконати коректний запит
Випадки використання
- Швидко зрозуміти незнайомий код стану, який повертає API, з яким ви інтегруєтеся
- Вирішити, який код стану повертати з власного API для певної умови помилки
- Налагодити, чому запит не виконується, перевіривши, що насправді означає конкретний код
- Викладати або вивчати основи HTTP на курсі з веброзробки
- Писати точну логіку обробки помилок, яка розрізняє різні випадки 4xx і 5xx
Ключові переваги
- Усі часто використовувані коди стану в одному пошуковому довіднику
- Прості пояснення, а не лише формальна термінологія RFC
- Миттєва фільтрація за категорією (від 1xx до 5xx)
- Безкоштовно, швидко, без реєстрації
Поради
- Резервуйте коди 5xx виключно для збоїв на боці сервера — ніколи не використовуйте їх для позначення помилок введення клієнта
- Використовуйте 429 із заголовком Retry-After під час обмеження частоти запитів, щоб коректні клієнти знали, коли повторити спробу
- Надавайте перевагу 404 замість загальної сторінки помилки, коли ресурс справді не існує — це краще і для користувачів, і для пошукових систем
- Під час проєктування API обирайте конкретні коди 4xx (422, 409, 400), а не зводьте все до загального 400
Поширені помилки
- Повернення 200 OK для запиту, який насправді завершився помилкою, що приховує помилки від систем моніторингу
- Плутанина між 401 (не автентифікований) і 403 (автентифікований, але без прав)
- Використання 302 для перенаправлення, яке має бути постійним (301), що шкодить SEO
- Однакова обробка всіх помилок 4xx і 5xx у клієнтській логіці замість розгалуження за конкретним кодом
Ключові терміни
- Рядок стану: Перший рядок відповіді HTTP, що містить код стану та коротку пояснювальну фразу
- Ідемпотентність: Властивість деяких методів HTTP, за якої повторення того самого запиту має такий самий ефект, як і його одноразове виконання
- Ланцюжок перенаправлень: Послідовність кількох перенаправлень, які браузер проходить, перш ніж досягнути кінцевого ресурсу
- Обмеження частоти запитів: Обмеження кількості запитів, які клієнт може зробити за певний проміжок часу, часто позначається кодом 429
Пов'язані концепції
- Форматувальник JSON:
- Валідатор JSON:
- Тестер регулярних виразів:
- Кодувальник/декодувальник URL:
- Кодувальник/декодувальник Base64:
Приклад
Пошук "429" повертає "Too Many Requests" — код, який API повертають, коли ви перевищили ліміт запитів, повідомляючи вам сповільнитися та повторити спробу після паузи.
Інтерпретація результатів
Коди стану HTTP групуються в п'ять класів за першою цифрою. 1xx мають інформаційний характер і рідко трапляються в коді застосунків. 2xx підтверджують успіх — 200 OK найпоширеніший, але 201 Created і 204 No Content також часті в REST API. 3xx відповідають за перенаправлення, найважливіші з яких 301 (постійне) і 302 (тимчасове).
Помилки 4xx вказують на проблему із запитом клієнта. Найпоширеніші з них: 400 Bad Request (неправильний синтаксис), 401 Unauthorized (не автентифікований), 403 Forbidden (немає прав), 404 Not Found (ресурс не існує) і 429 Too Many Requests (перевищено ліміт запитів). Правильне використання конкретних кодів 4xx робить ваш API набагато простішим для налагодження, ніж повернення загального 400 для всього.
Помилки 5xx означають, що збій стався на сервері. 500 — загальна внутрішня помилка, 502 Bad Gateway вказує на проблему з вищим сервером, а 503 Service Unavailable зазвичай означає, що сервер перевантажений або вимкнений на обслуговування. Під час налагодження помилок 5xx перевіряйте журнали сервера, а не відповідь на боці клієнта, оскільки сам код стану рідко розкриває першопричину.