Preskočiť na hlavný obsah

Referencia HTTP stavových kódov zadarmo

Prehľadávateľná referencia pre všetky HTTP stavové kódy — čo každý znamená, kedy sa používa a bežné príčiny. Od 100 do 511.

Po načítaní funguje offline

61 stavových kódov

100

Pokračovať

Server prijal hlavičky požiadavky a klient by mal pokračovať v odoslaní tela.

Používa sa pre požiadavky s hlavičkou Expect: 100-continue. Server potvrdzuje, že je ochotný prijať telo pred tým, ako klient pošle telo. V moderných webových aplikáciách sa vyskytuje zriedka.

RFC 9110 ↗
101

Prepínanie protokolov

Server prepína protokoly podľa požiadavky klienta.

Najčastejšie sa používa na upgrady WebSocket — klient požaduje Upgrade: websocket a server odpovedá 101 na zmenu.

RFC 9110 ↗
102

Spracovávanie

Server prijal požiadavku a spracováva ju, ale zatiaľ nie je dostupná žiadna odpoveď.

Dočasná odpoveď WebDAV odoslaná na zabránenie vypršaniu času klienta počas dlhých operácií. Zastarané — moderné servery by ju nemali odosielať.

RFC 2518 ↗
103

Varovania dopredu

Predbežné hlavičky odoslané pred konečnou odpoveďou.

Umožňuje serverom odoslať hlavičky Link (preload/preconnect) počas prípravy konečnej odpovede, aby mohli prehliadače skôr začať s načítavaním kritických zdrojov.

RFC 8297 ↗
200

OK

Požiadavka bola úspešná.

Štandardná úspešná odpoveď. Jej význam závisí od metódy HTTP: GET → vrátený zdroj, POST/PUT → dokončená akcia.

RFC 9110 ↗
201

Vytvorené

Nový zdroj bol úspešne vytvorený.

Bežné po POST. Odpoveď by mala obsahovať hlavičku Location ukazujúcu na URL nového zdroja.

RFC 9110 ↗
202

Akceptované

Požiadavka bola akceptovaná na spracovanie, ale spracovanie nie je dokončené.

Pre asynchrónne operácie — server zaraďuje prácu do poradia. Klient by mal opakovane skúšať endpoint stavu alebo neskôr skontrolovať.

RFC 9110 ↗
203

Neautoritatívne informácie

Odpoveď bola zmenená transformujúcim proxy.

Požiadavka bola úspešná, ale sprostredkovateľ (napríklad proxy s ukladaním do vyrovnávacej pamäte alebo transformáciou) zmenil obsah z pôvodného servera — napríklad opätovnou kompresiou obrázkov. V praxi zriedkavé.

RFC 9110 ↗
204

Bez obsahu

Požiadavka bola úspešná, ale neexistuje teleso odpovede.

Často sa používa na operácie DELETE alebo aktualizácie PUT, ktoré nemusia vracať telo. Klient by nemali opustiť aktuálnu stránku.

RFC 9110 ↗
205

Resetovať obsah

Požiadavka bola úspešná; klient by mal resetovať zobrazenie dokumentu.

Podobne ako 204, žiadne telo sa nevracia — ale klientovi sa dodatočne povie, aby resetoval formulár alebo zobrazenie, ktoré vytvorilo požiadavku (napr. vyčistil polia formulára pre ďalší vstup).

RFC 9110 ↗
206

Čiastočný obsah

Server doručil iba časť zdroja.

Odpoveď na požiadavku Range. Používajú ho prehrávače videa a správcovia sťahovania na obnovenie prerušených sťahovaní alebo streamovanie veľkých súborov.

RFC 9110 ↗
207

Viacstavový

Teleso odpovede obsahuje viacero stavových kódov pre viacero operácií.

WebDAV: telo XML hlási výsledok niekoľkých podoperácií nezávisle — napr. hromadný presun, kde niektoré položky uspeli a iné zlyhal.

RFC 4918 ↗
208

Už nahlásené

Členovia kolekcie boli už uvedení v predchádzajúcej časti odpovede.

WebDAV: používa sa v odpovediach 207 Multi-Status, aby sa zabránilo opakovaniu výpisu členov tej istej kolekcie, keď väzby vytvárajú slučky.

RFC 5842 ↗
226

IM použitý

Odpoveď je výsledkom manipulácií inštancií aplikovaných na zdroj.

Kódovanie delta: server vráti rozdiel od predchádzajúcej verzie namiesto úplného zdroja, čím šetrí šírku pásma. Veľmi zriedka implementované.

RFC 3229 ↗
300

Viacero možností

Dostupných je viacero reprezentácií zdroja.

Server ponúka viacero možností (napr. rôzne formáty alebo jazyky) a klient by si mal vybrať jednu. Zriedka sa používa, pretože automatické rokovanie obsahu to zvyčajne rieši.

RFC 9110 ↗
301

Trvalo presunuté

Zdroj sa trvalo presunul na novú URL.

Používajte na trvalé zmeny URL — vyhľadávače aktualizujú svoj index. Autorita SEO sa prenáša na novú URL.

RFC 9110 ↗
302

Nájdené (dočasné presmerovanie)

Zdroj sa dočasne nachádza na inej URL.

Naznačuje, že presmerovanie nie je trvalé. Ukladanie do vyrovnávacej pamäte je menej agresívne ako 301. Používajte na veci ako 'je potrebná prihlasovacia stránka, presmerovanie na /login'.

RFC 9110 ↗
303

Pozri inde

Presmerovať na inú URL pomocou GET.

Používa sa po odoslaní POST — odpoveď hovorí 'váš POST fungoval, pozrite sa na túto URL GET na výsledok'. Prehliadače vždy vykonajú GET na novú URL.

RFC 9110 ↗
304

Nezmenené

Verzia s vyrovnávacou pamäťou je stále platná; používajte ju.

Odpoveď na podmienené požiadavky (s hlavičkami If-None-Match alebo If-Modified-Since). Šetrí šírku pásma — žiadne teleso sa nevracia.

RFC 9110 ↗
307

Dočasné presmerovanie

Podobne ako 302, ale zachováva pôvodnú metódu HTTP.

Ak bol pôvodný POST, presmerovanie tiež používa POST. Moderná alternatíva k 302, keď je dôležitá presnosť metódy.

RFC 9110 ↗
308

Trvalé presmerovanie

Podobne ako 301, ale zachováva pôvodnú metódu HTTP.

Moderná náhrada za 301, ak chcete, aby požiadavky POST ostali POST po presmerovaní.

RFC 9110 ↗
400

Nesprávna požiadavka

Server nemohol pochopiť požiadavku z dôvodu chybnej syntax.

Bežné príčiny: zle formátovaný JSON v tele, neplatné parametre dopytu alebo chýbajúce povinné polia. Skontrolujte telo požiadavky a hlavičky.

RFC 9110 ↗
401

Neoprávnené

Overenie je povinné a nie je poskytnované.

Klient musí obsahovať poverzovacie údaje (hlavička Authorization, súbor cookie, token). 'Neoprávnené' je nesprávny výraz — v skutočnosti to znamená 'neoverené'.

RFC 9110 ↗
402

Platba požadovaná

Vyhradené na budúce použitie — niekedy sa používa pre platenej úrovne API.

Pôvodne určené pre digitálne platby. Moderné použitie: niektoré API vracajú 402, keď používateľ prekročil svoju platenú kvótu.

RFC 9110 ↗
403

Zakázané

Klient je overený, ale nemá oprávnenie.

Odlišne od 401 — používateľ JE prihlásený, ale jeho účet nemá oprávnenie na tento zdroj. Skontrolujte logiku rolí/oprávnení.

RFC 9110 ↗
404

Nenájdené

Požadovaný zdroj neexistuje.

Buď je URL nesprávna, zdroj bol vymazaný, alebo nikdy neexistoval. Servery niekedy vracajú 404, aby skryli, že 403 by bolo presnejšie.

RFC 9110 ↗
405

Metóda nie je povolená

Metóda HTTP použitá nie je povolená pre tento zdroj.

Napríklad požiadavka GET na endpoint, ktorý akceptuje iba POST. Odpoveď by mala obsahovať hlavičku Allow s výpisom platných metód.

RFC 9110 ↗
406

Nie je prijateľné

Žiadna reprezentácia nezodpovedá hlavičkám Accept klienta.

Klient požiadal o typ obsahu, jazyk alebo kódovanie (cez Accept, Accept-Language, Accept-Encoding), ktoré server nemôže poskytnúť. Mnoho serverov preskakovateľ prísne rokovanie a vráti predvolené.

RFC 9110 ↗
407

Požadované overenie proxy

Klient sa musí najprv autentifikovať s proxy.

Podobne ako 401, ale vydané proxy: klient musí poslať overzovacie údaje Proxy-Authorization. Viditeľné v podnikových sieťach s overovacími proxysi.

RFC 9110 ↗
408

Časový limit žiadosti

Serveru vypršal časový limit pri čakaní na požiadavku.

Klient príliš dlho poslal telo požiadavky alebo ponechal pripojenie nečinné. Skúste požiadavku opätovne.

RFC 9110 ↗
409

Konflikt

Požiadavka je v rozpore s aktuálnym stavom zdroja.

Zvyčajne sa vracia pri konfliktoch paralelného upravovania alebo duplikátnom vytváraní zdroja (napr. vytvorenie používateľa s e-mailom, ktorý už existuje).

RFC 9110 ↗
410

Zmazané

Zdroj bol zmazaný a nevrátí sa.

Silnejšie ako 404 — server explicitne pozná, že zdroj KEDYSI existoval, ale bol natrvalo odstránený. Vyhľadávače ho budú deindexovať.

RFC 9110 ↗
411

Vyžadovaná dĺžka

Server vyžaduje hlavičku Content-Length.

Požiadavka bola odmietnuta, pretože jej chýbala hlavička Content-Length a server odmieta telesá s neznámou veľkosťou. Pridajte hlavičku a skúste znova.

RFC 9110 ↗
412

Podmienka nebola splnená

Podmienka v hlavičkách požiadavky nebola splnená.

Vracia sa, keď podmienené hlavičky ako If-Match alebo If-Unmodified-Since zlyhajú — zvyčajne optimistický zámok: niekto iný zmenil zdroj od vašej verzie. Znova si stiahnite a skúste znova.

RFC 9110 ↗
413

Obsah je príliš veľký

Telo požiadavky prekračujeLimit veľkosti servera.

Bežné pri nahrávaní veľkých súborov. Konfigurácia servera (nginx, apache) nastaví maximálnu veľkosť tela. Skontrolujte konfiguráciu servera.

RFC 9110 ↗
414

URI je príliš dlhé

Adresa URL požiadavky prekračuje limit dĺžky servera.

Zvyčajne spôsobené veľmi dlhými reťazcami dotazov (napr. kódovanie údajov v GET). Prepnite sa na telo POST alebo zvýšte limit servera, ak ho kontrolujete.

RFC 9110 ↗
415

Nepodporovaný typ média

Server nemôže spracovať odoslanú hlavičku Content-Type.

Napríklad odoslanie application/xml serveru, ktorý akceptuje iba application/json. Správne nastavte hlavičku Content-Type.

RFC 9110 ↗
416

Rozsah nie je uspokojujúci

Požadovaný rozsah bajtov je mimo veľkosti zdroja.

Hlavička Range požaduje časť, ktorú súbor nemá — napríklad obnovenie sťahovania za koncom súboru. Odpoveď by mala zahŕňať Content-Range so skutočnou veľkosťou.

RFC 9110 ↗
417

Očakávanie zlyhalo

Server nemôže spĺňať požiadavky hlavičky Expect.

Poslané, keď server nepodporuje Expect: 100-continue. Niektorí klienti budú posielať túto hlavičku štandardne na veľké POST požiadavky; jej zakázanie zvyčajne vyrieši chybu.

RFC 9110 ↗
418

Som čajník

Server odmieta variť kávou, pretože je čajník.

Aprílový žart z roku 1998 (RFC 2324). Niektoré reálne API ho používajú na žarty alebo na označenie zastaraných koncových bodov. Nie je určený na použitie v produkcii.

RFC 2324 ↗
421

Chybne nasmerovaná požiadavka

Požiadavka bola odoslaná serveru, ktorý nemôže vytvoriť odpoveď.

Bežné s opätovným použitím pripojenia HTTP/2: požiadavka dorazila na server, ktorý nie je nakonfigurovaný pre cieľový názov hostiteľa. Klient by mal skúsiť znova na novom pripojení.

RFC 9110 ↗
422

Spracovateľný obsah

Požiadavka bola syntakticky platná, ale sémanticky nesprávna.

Napríklad JSON bol správne analyzovaný, ale chýbalo povinné pole alebo hodnota poľa bola mimo rozsahu. Bežné v odpovediach validácie REST API.

RFC 9110 ↗
423

Uzamknuté

Zdroj je uzamknutý.

WebDAV: zdrojový alebo cieľový zdroj je uzamknutý iným klientom, takže operácia nemôže pokračovať. Čakajte na uvoľnenie zámku alebo ho prerazte správnym tokeníkom.

RFC 4918 ↗
424

Neúspešná závislosť

Požiadavka zlyhala, pretože zlyhala predchádzajúca závislá požiadavka.

WebDAV: v reťazci závislých operácií zlyhala skoršia akcia, takže táto nebola vykonaná. Pozrite sa na skoršie zlyhanie, aby ste našli hlavnú príčinu.

RFC 4918 ↗
425

Príliš skoro

Server odmieta spracovať požiadavku, ktorá môže byť opätovne prehrávana.

Súvisí s TLS 1.3 0-RTT (ranými údajmi): server si nebude robiť starosti spracúvaním možne opakovane prehrávané požiadavky. Klient by mal skúsiť znova po dokončení handshaku.

RFC 8470 ↗
426

Upgrade vyžadovaný

Klient sa musí prepnúť na iný protokol.

Server odmieta slúžiť požiadavku cez aktuálny protokol, ale bude po upgrade — odpoveď zahŕňa hlavičku Upgrade s názvom požadovaného protokolu.

RFC 9110 ↗
428

Podmienka vyžadovaná

Server vyžaduje, aby bola požiadavka podmienená.

Server požaduje podmienené hlavičky (ako If-Match) na zabránenie konfliktom straty aktualizácie. Stiahnite si zdroj, zachyťte jeho ETag a opätovne odošlite s If-Match.

RFC 6585 ↗
429

Príliš veľa požiadaviek

Klient je rýchlostne limitovaný.

Spomaliť. Odpoveď by mala zahŕňať hlavičku Retry-After, ktorá označuje, kedy sa má skúsiť znova. Bežné s API, ktoré majú kvóty požiadaviek.

RFC 6585 ↗
431

Polia hlavičky požiadavky sú príliš veľké

Hlavičky sú príliš veľké na spracovanie serverom.

Buď jedna hlavička alebo celková veľkosť hlavičky prekračuje limit — najčastejšie spôsobené nadmerným rozmerom cookies. Vyčistite cookies alebo znížte, čo vaša aplikácia v nich ukladá.

RFC 6585 ↗
451

Nedostupné z právnych dôvodov

Prístup zakázaný z právnych dôvodov.

Zdroj je blokovaný z právnych dôvodov — cenzúra, rozhodnutia súdov alebo regionálne predpisy. Číslo je narážka na román Fahrenheit 451.

RFC 7725 ↗
500

Interná chyba servera

Server narazil na neočakávanú podmienku.

Všeobecný základ pre chyby na strane servera. Skontrolujte protokoly servera na skutočnú príčinu: nezpracovaná výnimka, chyba databázy atď.

RFC 9110 ↗
501

Nie je implementované

Server nepodporuje požadovanú funkcionalitu.

Napríklad server nepozná HTTP metódu. Zriedka v praxi — viac často vidíte 405.

RFC 9110 ↗
502

Nesprávna brána

Server, pôsobiaci ako brána, dostal zlú odpoveď zo servera upstream.

Bežné v architektúrach mikroslužieb. Váš nástroj na vyrovnávanie zátaže alebo reverzný proxy dostal malformovanú odpoveď zo služby backend.

RFC 9110 ↗
503

Služba nedostupná

Server je dočasne neschopný spracovať požiadavku.

Buď v konfigurácii alebo prepracovaný. Odpoveď by mala obsahovať hlavičku Retry-After. Často sa vracia počas nasadení.

RFC 9110 ↗
504

Časový limit brány

Server brány vypršal časový limit pri čakaní na odpoveď upstream.

Služba backend nereagovala dostatočne rýchlo. Skontrolujte stav upstream služby a konfiguráciu časových limitov.

RFC 9110 ↗
505

Verzia HTTP nie je podporovaná

Server nepodporuje verziu HTTP použitú v požiadavke.

Hlavná verzia HTTP požiadavky nie je podporovaná serverom. Takmer nikdy nie je videná u moderných klientov.

RFC 9110 ↗
506

Variant sa tiež vyjednáva

Server má chybnú konfiguráciu vyjednávania obsahu.

Transparentné vyjednávanie obsahu skončilo slučkou: zvolená varianta je sama nakonfigurovaná na vyjednávanie. Označuje chybu konfigurácie servera.

RFC 2295 ↗
507

Nedostatočné úložisko

Serveru sa došiel diskový priestor.

Pôvod WebDAV-špecifický, ale niekedy sa používa všeobecnými servermi. Znamená, že server nemôže uložiť požiadavku z dôvodu obmedzení úložného priestoru.

RFC 4918 ↗
508

Slučka detekovaná

Server detekoval nekonečnú slučku pri spracovaní požiadavky.

WebDAV: spracovanie požiadavky Depth: infinity vstúpilo do slučky (napr. cirkulárne väzby). Operácia bola ukončená.

RFC 5842 ↗
510

Nie je rozšírené

Vyžadujú sa ďalšie rozšírenia požiadavky.

Z zastaraného HTTP Extension Framework: server potrebuje ďalšie informácie, aby mohol splniť požiadavku. Prakticky nepoužívané na modernom webe.

RFC 2774 ↗
511

Vyžadovaná autentifikácia siete

Klient sa musí autentifikovať, aby získal prístup k sieti.

Používané captivnými portálmi (hotel/airport WiFi) na označenie, že sa používateľ musí najprv prihlásiť do siete, aby mal prístup na externé stránky.

RFC 6585 ↗

Bežné použitia

  • Referencia na API návrhPri návrhu REST API vyberte správny stavový kód pre každú odpoveď.
  • Rýchlo vyhľadajte kódy chýbKeď vaša aplikácia vráti mätúcu chybu HTTP, vyhľadajte, čo to naozaj znamená.
  • Naučte sa kódy stavu HTTPKomplexná referencia pre študentov a vývojárov, ktorí sa učia HTTP a REST.
  • Rýchla referencia počas incidentovPočas výrobných incidentov rýchlo vyhľadajte, čo znamená každý stavový kód.
  • Referencia pre API dokumentáciuPri písaní dokumentácie API sa pripojte na autoritatívne popisy stavových kódov, ktoré vrátite.

Ako to funguje

Tento nástroj je klientská referencia postavená okolo pevne zakódovanej vyhľadávacej tabuľky 63 stavových kódov HTTP zahŕňajúcich všetkých päť tried (1xx–5xx), z ktorých každý je označený číslom RFC, ktoré ho definuje. Nie je tu žiadne volanie servera, žiadne externé API a žiadna sieťová požiadavka — celé filtrovanie a zobrazenie prebieha v prehliadači pomocou vstavaných metód JavaScriptu pre polia a reťazce.

  1. 1
    Vyhľadávacia tabuľka sa načíta
    Celá sada 63 stavových kódov registrovaných IANA je zabudovaná priamo do tohto nástroja ako pole JavaScript, kde každá položka nesie číselný kód, kanonický anglický názov, triedu kategórie a konkrétne RFC, ktoré ju definuje (napr. RFC 9110 pre väčšinu kódov HTTP/1.1, RFC 6585 pre 429 Too Many Requests, RFC 2324 pre 418 I'm a Teapot).
  2. 2
    Filter beží v pamäti
    Počas písania alebo výberu filtra kategórie beží Array.filter JavaScriptu nad zoznamom v pamäti a porovnáva váš dopyt s číslom stavového kódu, kanonickým názvom a krátkym aj dlhým popisným reťazcom pomocou String.includes — bez oneskorenia, bez okruhu na server.
  3. 3
    Detaily sa rozbaľujú s odkazom na RFC
    Každý výsledok sa vykreslí ako element HTML details/summary. Rozbalenie záznamu odhalí dlhé vysvetlenie a priamy odkaz na autoritatívne RFC na rfc-editor.org, takže si môžete prečítať presný text špecifikácie pre ľubovoľný kód.
  4. 4
    Priame odkazy a kopírovanie do schránky
    Otvorenie záznamu aktualizuje hash URL na číslo kódu (napr. #404), čo robí stránku zdieľateľnou a vhodnou na uloženie medzi záložky. Tlačidlo kopírovania zapíše kanonický reťazec (napr. „404 Not Found“) do schránky cez API navigator.clipboard prehliadača.

Súvisiace nástroje

Často kladené otázky