Довідник кодів стану HTTP
| Код | Назва | Значення |
|---|---|---|
| 100 | Продовжити | Клієнт має продовжити з тілом запиту |
| 101 | Перемикання протоколів | Оновлення протоколу прийнято (наприклад, до WebSocket) |
| 200 | OK | Запит успішний — стандартна відповідь успіху |
| 201 | Створено | Створено новий ресурс (типовий успіх POST) |
| 202 | Прийнято | У черзі на асинхронну обробку, ще не завершено |
| 204 | Немає вмісту | Успіх із навмисно порожнім тілом |
| 301 | Переміщено назавжди | Ресурс має нову постійну URL-адресу — оновіть посилання; вага SEO переноситься |
| 302 | Знайдено | Тимчасове перенаправлення (історично вживане неправильно; див. 303/307) |
| 303 | Див. інше | Перенаправлення на GET за іншою URL-адресою (post/redirect/get) |
| 304 | Не змінено | Кешована копія досі дійсна — перевірте повторно через ETag/Last-Modified |
| 307 | Тимчасове перенаправлення | Тимчасове перенаправлення зі збереженням методу й тіла |
| 308 | Постійне перенаправлення | Постійне перенаправлення зі збереженням методу й тіла |
| 400 | Поганий запит | Сервер не може розібрати/зрозуміти запит |
| 401 | Не авторизовано | Потрібна автентифікація або вона не вдалася (попри назву, це означає «не автентифіковано») |
| 403 | Заборонено | Незалежно від автентифікації, у доступі відмовлено |
| 404 | Не знайдено | За цією URL-адресою немає ресурсу |
| 405 | Метод не дозволено | Метод HTTP не підтримується для цього ресурсу |
| 406 | Неприйнятно | Жодне подання не відповідає заголовкам Accept |
| 408 | Час очікування запиту вичерпано | Клієнт надто довго надсилав запит |
| 409 | Конфлікт | Конфлікт стану, наприклад колізія редагування або створення дубліката |
| 410 | Зникло | Видалено назавжди (сильніше за 404 — використовується навмисно) |
| 411 | Потрібна довжина | Потрібен заголовок Content-Length |
| 413 | Вміст занадто великий | Тіло запиту перевищує обмеження сервера |
| 414 | URI задовгий | URL-адреса перевищує обмеження сервера |
| 415 | Тип медіа не підтримується | Content-Type запиту не підтримується |
| 418 | Я — чайник | Жартівливий код RFC 2324, який іноді використовують, щоб відмовитися заварювати каву |
| 422 | Вміст, який не можна обробити | Синтаксис у порядку, але семантика не проходить валідацію (API це обожнюють) |
| 425 | Зарано | Сервер не бажає обробляти, можливо, повторений запит |
| 429 | Забагато запитів | Досягнуто обмеження частоти — відступіть, дотримуйтеся Retry-After |
| 500 | Внутрішня помилка сервера | Загальний збій на боці сервера |
| 501 | Не реалізовано | Сервер не підтримує цю функціональність |
| 502 | Поганий шлюз | Проксі/шлюз отримав недійсну відповідь від вищого сервера |
| 503 | Служба недоступна | Перевантажено або вимкнено на обслуговування — часто тимчасово, може нести Retry-After |
| 504 | Час очікування шлюзу вичерпано | Час очікування проксі/шлюза на вищий сервер вичерпано |
| 505 | Версія HTTP не підтримується | Версія HTTP у запиті не підтримується |
Про нас
Коди стану — це одночисловий підсумок сервера про кожну відповідь, згрупований за класами: 1xx інформаційні, 2xx успіх, 3xx перенаправлення, 4xx помилився клієнт, 5xx помилився сервер. Таблиця дає коди, які робочі розробники насправді зустрічають, із нюансами, що важать на практиці: 401 означає неавтентифікований, попри свою назву; 403 — відмова незалежно від входу; 422 — невдача валідації API; 429 вимагає відступу. Коди, яких немає в переліку (довгий хвіст 1xx та експериментальні коди), досить рідкісні, щоб сам клас казав вам, як із ними поводитися.
Часті запитання
Яка різниця між 401 і 403?
401: ми не знаємо, хто ви (автентифікуйтеся). 403: ми знаємо, і вам усе одно не можна.
302 чи 307 для тимчасового перенаправлення?
307 зберігає метод і тіло; 302 історично дозволяв клієнтам змінювати POST на GET. Для нової роботи слід використовувати 307 (або 308 для постійного).