Справочник за 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 | Неподдържан тип медия | Типът съдържание на заявката не се поддържа |
| 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 за постоянно).