Referenční přehled stavových kódů HTTP
| Kód | Název | Význam |
|---|---|---|
| 100 | Pokračovat | Klient by měl pokračovat tělem požadavku |
| 101 | Přepínání protokolů | Upgrade protokolu přijat (např. na WebSocket) |
| 200 | OK | Požadavek uspěl — výchozí úspěšná odpověď |
| 201 | Vytvořeno | Byl vytvořen nový zdroj (typický úspěch POST) |
| 202 | Přijato | Zařazeno do fronty na asynchronní zpracování, zatím nedokončeno |
| 204 | Žádný obsah | Úspěch se záměrně prázdným tělem |
| 301 | Trvale přesunuto | Zdroj má novou trvalou URL — aktualizujte odkazy; hodnota SEO se přenáší |
| 302 | Nalezeno | Dočasné přesměrování (historicky zneužíváno; viz 303/307) |
| 303 | Viz jiné | Přesměrování na GET na jinou URL (post/redirect/get) |
| 304 | Nezměněno | Uložená kopie je stále platná — znovu ověřte přes ETag/Last-Modified |
| 307 | Dočasné přesměrování | Dočasné přesměrování zachovávající metodu a tělo |
| 308 | Trvalé přesměrování | Trvalé přesměrování zachovávající metodu a tělo |
| 400 | Chybný požadavek | Server nemůže požadavek analyzovat/pochopit |
| 401 | Neoprávněný přístup | Vyžaduje se ověření nebo selhalo (navzdory názvu to znamená neověřený) |
| 403 | Zakázáno | Ať ověřený, nebo ne, přístup je odmítnut |
| 404 | Nenalezeno | Žádný zdroj na této URL |
| 405 | Metoda není povolena | Metoda HTTP není pro tento zdroj podporována |
| 406 | Nepřijatelné | Žádná reprezentace neodpovídá záhlavím Accept |
| 408 | Časový limit požadavku | Klient trval příliš dlouho, než poslal požadavek |
| 409 | Konflikt | Konflikt stavu, např. kolize úprav nebo duplicitní vytvoření |
| 410 | Pryč (Gone) | Trvale odstraněno (silnější než 404 — použito záměrně) |
| 411 | Vyžaduje se délka | Vyžaduje se záhlaví Content-Length |
| 413 | Obsah je příliš velký | Tělo požadavku překračuje limity serveru |
| 414 | URI je příliš dlouhá | URL přesahuje limity serveru |
| 415 | Nepodporovaný typ média | Typ Content-Type požadavku není podporován |
| 418 | Jsem konvice na čaj | Žertovný kód RFC 2324, občas používaný k odmítnutí vaření kávy |
| 422 | Nezpracovatelný obsah | Syntaxe je v pořádku, ale sémantika neprojde validací (API to milují) |
| 425 | Příliš brzy | Server není ochoten zpracovat požadavek, který by mohl být opakováním dřívějšího |
| 429 | Příliš mnoho požadavků | Dosažen limit rychlosti — zpomalte, respektujte Retry-After |
| 500 | Interní chyba serveru | Obecné selhání na straně serveru |
| 501 | Neimplementováno | Server nepodporuje požadovanou funkcionalitu |
| 502 | Špatná brána | Proxy/brána dostala od upstreamu neplatnou odpověď |
| 503 | Služba nedostupná | Přetížený nebo mimo provoz kvůli údržbě — často dočasné, může nést Retry-After |
| 504 | Časový limit brány | Proxy/brána vypršela při čekání na upstream |
| 505 | Verze HTTP není podporována | Verze HTTP v požadavku není podporována |
O aplikaci
Stavové kódy jsou jednočíselné shrnutí každé odpovědi serverem, seskupené podle tříd: 1xx informační, 2xx úspěch, 3xx přesměrování, 4xx chyba klienta, 5xx chyba serveru. Tabulka uvádí kódy, se kterými se pracující vývojáři skutečně setkávají, s nuancemi, na kterých v praxi záleží — 401 znamená neověřeno navzdory svému názvu, 403 je odmítnutí bez ohledu na přihlášení, 422 je chyba validace API, 429 vyžaduje zpětné čekání (backoff). Kódy, které nejsou uvedeny (dlouhý ocas 1xx a experimentální kódy), jsou dost vzácné na to, aby vám samotná třída řekla, jak s nimi naložit.
Často kladené otázky
Jaký je rozdíl mezi 401 a 403?
401: nevíme, kdo jste (ověřte se). 403: víme, a přesto nesmíte.
302, nebo 307 pro dočasné přesměrování?
307 zachovává metodu a tělo; 302 historicky dovolovalo klientům přepnout POST na GET. Nová práce by měla používat 307 (nebo 308 pro trvalé).