У цій статті
Що таке коди стану HTTP?
Коди стану HTTP — це тризначні числа, які повертаються веб-серверами у відповідь на запит клієнта. Вони вказують, чи був запит успішним, перенаправленим, спричинив помилку або потребує подальших дій. Щоразу, коли ви завантажуєте веб-сторінку, ваш браузер отримує один із цих кодів.
Коди стану визначені специфікацією HTTP (RFC 7231 та пов'язані RFC) і згруповані в п'ять класів за першою цифрою. Розуміння цих кодів є необхідним для веб-розробників, дизайнерів API та всіх, хто налагоджує веб-додатки.
П'ять категорій кодів стану
Коди стану HTTP організовані в п'ять категорій, кожна з яких вказує на різний тип відповіді.
- 1xx Інформаційні — запит отримано, обробка продовжується (напр., 100 Continue, 101 Switching Protocols)
- 2xx Успіх — запит успішно отримано, зрозуміло та прийнято (напр., 200 OK, 201 Created, 204 No Content)
- 3xx Перенаправлення — потрібна подальша дія для завершення запиту (напр., 301 Moved Permanently, 302 Found, 304 Not Modified)
- 4xx Помилка клієнта — запит містить неправильний синтаксис або не може бути виконаний (напр., 400 Bad Request, 401 Unauthorized, 403 Forbidden, 404 Not Found)
- 5xx Помилка сервера — сервер не зміг виконати дійсний запит (напр., 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable)
Спробуйте безкоштовно — реєстрація не потрібна
Шукати коди стану →Коли використовувати довідник кодів стану HTTP
Знання правильного коду стану для повернення або очікування є критичним для побудови надійних веб-сервісів.
- Розробка API — обрати правильний код відповіді для кожної кінцевої точки (201 для створення, 204 для видалення, 422 для помилок валідації)
- Налагодження — діагностика проблем, коли запити не вдаються (це проблема автентифікації 401 чи авторизації 403?)
- SEO та моніторинг — відстежувати перенаправлення 301/302, виявляти непрацюючі посилання 404 та моніторити помилки сервера 5xx
Часті запитання
Яка різниця між 401 і 403?
401 Unauthorized означає, що клієнт не надав дійсних облікових даних для автентифікації — користувач повинен увійти або надати ключ API. 403 Forbidden означає, що клієнт автентифікований, але не має дозволу на доступ до ресурсу. Коротко: 401 = «хто ви?», 403 = «я знаю, хто ви, але у вас немає доступу».
Коли використовувати перенаправлення 301 або 302?
Використовуйте 301 Moved Permanently, коли ресурс назавжди переміщено на нову URL-адресу — пошукові системи оновлять свій індекс. Використовуйте 302 Found (або 307 Temporary Redirect), коли перенаправлення є тимчасовим і оригінальна URL-адреса все ще повинна використовуватися в майбутньому. Використання неправильного коду може зашкодити SEO.
Що означає помилка 500 Internal Server Error?
Помилка 500 — це загальна помилка на стороні сервера, яка вказує, що щось пішло не так при обробці запиту, але сервер не може бути більш конкретним. Поширені причини включають необроблені виключення в коді додатка, збої підключення до бази даних, неправильно налаштовані сервери або проблеми з розгортанням. Перевірте журнали сервера для отримання деталей помилки.