Přehled HTTP stavových kódů zdarma

Používá se pro požadavky s Expect: 100-continue. Server potvrzuje, že je ochoten přijmout tělo předtím, než jej klient pošle. V moderních webových aplikacích se téměř nevidí.

Nejčastěji se používá pro upgrady WebSocket — klient požaduje Upgrade: websocket a server odpoví 101 pro přechod.

Zprostředkující odpověď WebDAV odeslaná k zabránění vypršení časového limitu klienta během dlouhých operací. Zastaralá — moderní servery by ji neměly odesílat.

Umožňuje serverům odesílat hlavičky Link (preload/preconnect) zatímco se připravuje finální odpověď, aby prohlížeče mohly začít dříve stahovat kritické zdroje.

Standardní odpověď na úspěch. Význam závisí na HTTP metodě: GET → zdroj vrácen, POST/PUT → akce dokončena.

Běžná odpověď po POST. Odpověď by měla obsahovat hlavičku Location ukazující na URL nového zdroje.

Pro asynchronní operace — server zařazuje práci do fronty. Klient by měl průběžně kontrolovat koncový bod stavu nebo se vrátit později.

Požadavek byl úspěšný, ale mezilehlý prvek (jako proxy pro ukládání do mezipaměti nebo transformaci) změnil obsah ze zdrojového serveru — například rekompresí obrázků. V praxi se vyskytuje zřídka.

Často se používá pro operace DELETE nebo PUT aktualizace, které nemusí vracet tělo. Klient by neměl opustit aktuální stránku.

Jako 204, není vráceno žádné tělo — ale klient je navíc vyzván k resetování formuláře nebo pohledu, který vygeneroval požadavek (např. vymazání polí formuláře pro další zadání).

Odpověď na požadavek Range. Používá se přehrávači videí a správci stahování k obnovení přerušených stahování nebo streamování velkých souborů.

WebDAV: tělo XML hlásí výsledek několika dílčích operací nezávisle — např. hromadné přesunutí, kde některé položky uspěly a jiné selhaly.

WebDAV: používá se v 207 Multi-Status odpovědích, aby se zabránilo opakovanému výpisu členů stejné kolekce, když vazby vytvářejí smyčky.

Delta kódování: server vrací rozdíl vůči předchozí verzi místo úplného zdroje, čímž šetří šířku pásma. Velmi zřídka implementováno.

Server nabízí více možností (např. různé formáty nebo jazyky) a klient by měl vybrat jednu. Zřídka se používá, protože automatická vyjednávání obsahu to obvykle zvládá.

Používá se pro trvalé změny URL — vyhledavače aktualizují svůj index. SEO autorita se přenese na novou URL.

Znamená, že přesměrování není trvalé. Ukládání do mezipaměti je méně agresivní než u 301. Používá se pro věci jako 'je vyžadováno přihlášení, přesměrování na /login'.

Používá se po odesláních POST — odpověď říká 'váš POST fungoval, výsledek najdete na této URL přes GET'. Prohlížeče vždy použijí GET na novou URL.

Odpověď na podmíněný požadavek (s hlavičkami If-None-Match nebo If-Modified-Since). Šetří šířku pásma — není vráceno žádné tělo.

Pokud byl originál POST, přesměrování také používá POST. Moderní alternativa k 302, pokud je zachování metody důležité.

Moderní náhrada za 301, pokud chcete, aby požadavky POST zůstaly POST po přesměrování.

Běžné příčiny: chybně formátovaný JSON v těle, neplatné parametry dotazu nebo chybějící povinná pole. Zkontrolujte tělo požadavku a hlavičky.

Klient musí obsahovat pověření pro ověřování (hlavička Authorization, cookie, token). 'Unauthorized' je nepřesný název — ve skutečnosti to znamená 'neověřeno'.

Původně určeno pro digitální platby. Moderní použití: API někdy vrátí 402, když uživatel překročil svou placenou kvótu.

Odlišuje se od 401 — uživatel JE přihlášen, ale jejich účet nemá oprávnění pro tento zdroj. Zkontrolujte logiku role/oprávnění.

URL je buď chybná, zdroj byl smazán, nebo nikdy neexistoval. Servery někdy vrací 404, aby skryli, že by 403 bylo přesnější.

Například GET požadavek na koncový bod, který přijímá pouze POST. Odpověď by měla obsahovat hlavičku Allow, která vypíše platné metody.

Klient požadoval typ obsahu, jazyk nebo kódování (přes Accept, Accept-Language, Accept-Encoding), které server nemůže poskytnout. Mnoho serverů přeskakuje přísné vyjednávání a vrací výchozí hodnotu.

Podobně jako 401, ale vystaveno proxy: klient musí zaslat pověření Proxy-Authorization. Vyskytuje se v podnikových sítích s ověřujícími proxy.

Klient příliš dlouho odesílal tělo požadavku nebo nechal připojení nečinné. Pokuste se požadavek zaslat znovu.

Obvykle se vrací při konfliktech současného upravování nebo při duplikování vytvoření prostředku (např. vytvoření uživatele s e-mailem, který již existuje).

Silnější než 404 — server explicitně ví, že prostředek EXISTOVAL, ale byl trvale odstraněn. Vyhledávače jej odstraní z indexu.

Požadavek byl odmítnut, protože chybí hlavička Content-Length a server odmítá těla neznámé velikosti. Přidejte hlavičku a zkuste znovu.

Vráceno při neúspěchu podmíněných hlaviček jako If-Match nebo If-Unmodified-Since — obvykle optimistické uzamykání: někdo jiný změnil prostředek od vaší verze. Načtěte znovu a zkuste znovu.

Běžné při nahrávání velkých souborů. Konfigurace serveru (nginx, apache) nastavuje maximální velikost těla. Zkontrolujte konfiguraci serveru.

Obvykle způsobeno velmi dlouhými řetězci dotazů (např. kódování dat v GET). Přepněte na tělo POST nebo zvyšte limit serveru, pokud jej kontrolujete.

Například odeslání application/xml na server, který přijímá pouze application/json. Nastavte správně hlavičku Content-Type.

Hlavička Range požaduje část, kterou soubor nemá — např. obnovení stahování za koncem souboru. Odpověď by měla obsahovat Content-Range se skutečnou velikostí.

Odesláno, když server nepodporuje Expect: 100-continue. Některé klienty tuto hlavičku standardně odesílají na velkých POSTech; deaktivace obvykle vyřeší chybu.

Aprilový vtip z roku 1998 (RFC 2324). Některá skutečná rozhraní API jej používají pro vtipy nebo k označení zastaralých koncových bodů. Není určeno pro produkční použití.

Běžné s opětovným použitím připojení HTTP/2: požadavek se dostal na server, který není nakonfigurován pro cílový název hostitele. Klient by se měl pokusit znovu na novém připojení.

Například JSON byl správně analyzován, ale chybí povinné pole nebo hodnota pole je mimo rozsah. Běžné v ověřovacích odpovědích REST API.

WebDAV: zdrojový nebo cílový prostředek je uzamčen jiným klientem, takže operace nemůže pokračovat. Čekejte na uvolnění zámku nebo jej rozbijte s příslušným tokenem.

WebDAV: v řetězci závislých operací selhala dřívější akce, takže tato nebyla provedena. Hledejte dřívější selhání pro určení základní příčiny.

Související s TLS 1.3 0-RTT (rané údaje): server nebude riskovat zpracování možná znovu přehraného požadavku. Klient by se měl pokusit znovu po dokončení handshaku.

Server se odmítá obsluhovat požadavek přes aktuální protokol, ale po přechodu na jiný protokol ho obslouží — odpověď obsahuje hlavičku Upgrade s názvem požadovaného protokolu.

Server vyžaduje podmíněné hlavičky (jako If-Match) aby se zabránilo ztrátě aktualizací. Načtěte prostředek, zachyťte jeho ETag a zašlete znovu s If-Match.

Zpomalte. Odpověď by měla obsahovat hlavičku Retry-After označující, kdy se znovu pokusit. Běžné u API s kvótami požadavků.

Buď jedna hlavička, nebo celková velikost hlavičky překračuje limit — nejčastěji způsobeno nadměrnými cookies. Vymažte cookies nebo snižte, co vaše aplikace v nich ukládá.

Prostředek je blokován z právních důvodů — cenzura, soudní příkazy nebo místní předpisy. Číslo je narážkou na román Fahrenheit 451.

Obecný záchyt pro chyby na straně serveru. Zkontrolujte protokoly serveru pro skutečnou příčinu: neošetřená výjimka, chyba databáze atd.

Například server nerozpozná HTTP metodu. V praxi vzácné — častěji uvidíte 405.

Běžné v architekturách mikroslužeb. Váš load balancer nebo reverzní proxy obdržel vadnou odpověď od back-end služby.

Buď v údržbě nebo přetíženo. Odpověď by měla obsahovat hlavičku Retry-After. Často se vrací během nasazení.

Back-end služba neodpověděla dostatečně rychle. Zkontrolujte stav upstream služby a konfigurace timeoutu.

Hlavní verze HTTP požadavku není serverem podporována. S moderními klienty se téměř nikdy nesetkáte.

Transparentní vyjednávání obsahu skončilo v smyčce: vybraná varianta je sama nakonfigurována na vyjednávání. Naznačuje chybu konfigurace serveru.

Původně specifické pro WebDAV, ale někdy používáno obecnými servery. Znamená, že server nemůže uložit požadavek z důvodu omezení úložiště.

WebDAV: zpracování požadavku Depth: infinity vstoupilo do smyčky (např. kruhové vazby). Operace byla ukončena.

Ze zastaralého HTTP Extension Framework: server potřebuje více informací, než aby mohl splnit požadavek. Prakticky nepoužíváno na moderním webu.

Používáno captive portály (WiFi v hotelu/letišti) k indikaci, že se uživatel musí přihlásit do sítě před přístupem na externí weby.