O HTTP Stavových Kódech
HTTP stavové kódy odpovědi označují, zda byl konkrétní HTTP požadavek úspěšně dokončen. Odpovědi jsou seskupeny do pěti tříd, každá identifikovaná první číslicí třímístného kódu.
Pět kategorií
- 1xx Informační: Požadavek byl přijat, pokračuje se v procesu.
- 2xx Úspěšné: Požadavek byl úspěšně přijat, pochopen a akceptován.
- 3xx Přesměrování: K dokončení požadavku je nutná další akce.
- 4xx Chyba klienta: Požadavek obsahuje špatnou syntaxi nebo nemůže být splněn.
- 5xx Chyba serveru: Server selhal při plnění platného požadavku.
Ať už ladíte API, čtete logy serveru nebo stavíte REST službu, znalost stavových kódů šetří čas. Naše reference vám umožňuje prohledávat a filtrovat všechny oficiální kódy, včetně neoficiálních jako 418 a 451.
Jak používat referenci HTTP stavových kódů
- Použijte vyhledávací panel pro nalezení konkrétního stavového kódu podle čísla (např. 404), názvu (např. Not Found) nebo klíčového slova z popisu. Vyhledávání funguje napříč všemi poli současně pro rychlé vyhledávání.
- Filtrujte podle kategorie pomocí tlačítek kategorií: 1xx (Informační), 2xx (Úspěch), 3xx (Přesměrování), 4xx (Chyba klienta) nebo 5xx (Chyba serveru). Kliknutí na kategorii okamžitě zúží seznam na kódy v dané třídě.
- Prohlédněte si barevně odlišené odznaky pro rychlou vizuální identifikaci: zelená pro kódy úspěchu, modrá pro přesměrování, žlutá/oranžová pro chyby klienta a červená pro chyby serveru.
- Klikněte na libovolný stavový kód pro rozbalení podrobných informací včetně oficiálního názvu, popisu, běžných příčin a pokynů pro řešení problémů.
Principy HTTP stavových kódů
HTTP stavové kódy jsou trojmístná čísla vracená webovým serverem v odpovědi na požadavek klienta, indikující výsledek požadavku. Definované v RFC 9110 (dříve RFC 7231), stavové kódy jsou seskupeny do pěti tříd podle první číslice. Kódy 1xx jsou informační, odesílané během provizorního zpracování serverem — v praxi se vyskytují zřídka, protože většina klientů čeká na konečnou odpověď. Kódy 2xx indikují úspěch: 200 OK pro úspěšné GET požadavky, 201 Created pro úspěšné POST požadavky, které vytvořily zdroj, a 204 No Content pro úspěšné požadavky bez těla odpovědi.
Kódy 3xx indikují přesměrování, říkající klientovi, aby hledal zdroj na jiné URL. Nejčastější jsou 301 Moved Permanently (používáno pro trvalé změny URL a SEO — vyhledávače přenášejí rankovací signály na nové URL) a 302 Found (dočasné přesměrování). Kódy 4xx indikují chyby klienta: 400 Bad Request (nesprávná syntaxe), 401 Unauthorized (vyžadována autentizace), 403 Forbidden (autentizováno ale nepovoleno), 404 Not Found (zdroj neexistuje) a 429 Too Many Requests (omezení rychlosti). Kódy 5xx indikují chyby serveru: 500 Internal Server Error (obecné selhání serveru), 502 Bad Gateway (neplatná odpověď nadřazeného serveru), 503 Service Unavailable (server přetížen nebo v údržbě) a 504 Gateway Timeout (časový limit nadřazeného serveru).
Porozumění stavovým kódům je nezbytné pro webové vývojáře, designéry API a správce systémů. Při ladění API integrací stavový kód říká, zda je problém na straně klienta (4xx — opravte svůj požadavek) nebo serveru (5xx — kontaktujte tým serveru). Konvence návrhu REST API specifikují, které kódy vrátit pro různé scénáře: 200 pro úspěšná čtení, 201 pro vytvoření zdroje, 204 pro úspěšné smazání, 400 pro chyby validace, 401 pro chybějící autentizaci, 403 pro nedostatečná oprávnění, 404 pro chybějící zdroje, 409 pro konflikty (např. duplicitní e-mail) a 500 pro neočekávaná selhání. HTTP/2 a HTTP/3 používají stejný prostor stavových kódů, čímž udržují zpětnou kompatibilitu.