Kode stanja HTTP so trimestni signali v odgovoru strežnika. Prva številka označuje splošni izid, preostali pa določajo posamezno stanje. Ta priročnik pojasnjuje registrirane standardne kode s praktičnim kontekstom ter izpostavlja vrednosti, značilne za posamezne ponudnike, ki se lahko pojavijo v dnevnikih.
Kode stanja HTTP so del protokola HTTP, ne funkcija brskalnika, ki bi jo posamezen ponudnik implementiral kot ločen spletni API. Sodobni brskalniki obdelujejo standardne razrede odgovorov; vidne strani napak in vedenje pri ponovnih poskusih pa sta specifična za brskalnik. Podpora za novejše vmesne odgovore in specializirane razširitve se lahko razlikuje glede na različico in omrežno pot.
| Družina odgovorov | Chrome / Edge | Firefox | Safari | Opera | Android / iOS WebView | Opomba o združljivosti |
|---|---|---|---|---|---|---|
| 1xx informativno | Podprto kot vmesni odgovor protokola | Podprto kot vmesni odgovor protokola | Podprto kot vmesni odgovor protokola | Podprto kot vmesni odgovor protokola | Podprto v osnovnem omrežnem skladu | Kode 100/101 so uveljavljene; 102 je specializirana ali zastarela. Uveljavitev 103 Early Hints in opazno prednalaganje se razlikujeta glede na različico brskalnika, strežnik in vmesni sistem. |
| 2xx uspeh | Podprto | Podprto | Podprto | Podprto | Podprto | Standardna semantika uspeha je skupna. Še vedno veljajo pravila glede telesa: na primer 204 in 205 nimata telesa odgovora. |
| 3xx preusmeritev | Podprto | Podprto | Podprto | Podprto | Podprto | Na navigacijo vplivajo Location, metoda, predpomnilnik in varnostna pravila. 301/302 lahko POST spremenita v GET; 307/308 metodo ohranita. |
| 4xx napaka odjemalca/zahteve | Podprto | Podprto | Podprto | Podprto | Podprto | Brskalnik prejme odgovor; prikaz telesa strežnika ali brskalnikovega lastnega prikaza napake se razlikuje glede na stanje in izdelek. |
| 5xx napaka strežnika | Podprto | Podprto | Podprto | Podprto | Podprto | Odjemalci lahko obdelajo razred odgovora, vendar strani, ki jih ustvari proxy, vedenje pri ponovnih poskusih in diagnostični vmesnik niso enaki v vseh brskalnikih. |
| Neprepoznana koda v znanem razredu | Obravnava na ravni razreda | Obravnava na ravni razreda | Obravnava na ravni razreda | Obravnava na ravni razreda | Obravnava na ravni razreda | Odjemalci lahko iz prve številke sklepajo na splošni razred; ne zanašajte se, da ima lastna koda standardno semantiko ali enak prikaz. |
Združljivost tukaj opisuje obravnavo na ravni protokola, ne zagotavlja pa, da vsak brskalnik prikaže enako stran napake. Starejši odjemalci, vdelani WebView, proxyji in prestrezni portali lahko delujejo drugače.
Strežnik je sprejel glave zahteve in čaka na preostalo telo zahteve. Pogosto se uporablja z Expect: 100-continue, da se odjemalec izogne nalaganju velikega telesa, če bo zahteva zavrnjena.
Operativno priporočilo: Vmesni odgovor; pošiljanje telesa nadaljujte samo, če se to pričakuje.
Strežnik se strinja s spremembo protokola za to povezavo, potem ko odjemalec zahteva nadgradnjo. Pogost primer je vzpostavitev povezave WebSocket.
Operativno priporočilo: Prehod na ravni povezave; preverite glavi Upgrade in Connection.
Strežnik WebDAV sporoča, da se je začela dolgotrajna operacija, ki še ni končana. Gre za zastarel odgovor, ki ga ne smemo zamenjati s končnim rezultatom.
Operativno priporočilo: Vmesno stanje WebDAV; počakajte na končni odgovor.
Strežnik med pripravo končnega odgovora pošlje predhodne glave, pogosto namige Link. Odjemalec lahko predčasno začne pridobivati verjetno ključna sredstva.
Operativno priporočilo: Vmesna optimizacija; slediti mora končni odgovor.
Zahteva je bila uspešna. Reprezentacija je odvisna od metode: GET vrne vir, HEAD vrne metapodatke brez telesa, dejanje zapisovanja pa lahko vrne predstavitev rezultata.
Operativno priporočilo: Uporabite za dokončano zahtevo, kadar je ustrezna predstavitev odgovora.
Zahteva je bila dokončana in je ustvarila enega ali več virov. Odgovor naj prepozna nov vir, običajno z Location, in lahko vrne njegovo predstavitev.
Operativno priporočilo: Običajno po POST ali PUT; zagotovite, da je ustvarjeni vir mogoče najti.
Strežnik je sprejel zahtevo v obdelavo, vendar ta še ni končana in lahko še vedno spodleti. HTTP za isto izmenjavo pozneje ne dostavi drugega odgovora.
Operativno priporočilo: Navedite URL operacije ali njenega stanja oziroma drug način za preverjanje končnega izida.
Proxy ali vmesni sistem, ki spreminja vsebino, je vrnil metapodatke ali vsebino, ki se razlikuje od odgovora izvornega strežnika. To pomeni, da odgovor ni neposredna avtoritativna predstavitev.
Operativno priporočilo: Uporabite samo, kadar je sprememba vmesnega sistema pomembna.
Zahteva je bila uspešna, vendar ni vsebine, ki bi jo bilo treba poslati. Glave lahko še vedno vsebujejo uporabne metapodatke, na primer posodobljene validatorje.
Operativno priporočilo: Ne vključite telesa odgovora.
Zahteva je bila uspešna, odjemalec pa mora ponastaviti pogled ali obrazec, iz katerega je bila poslana. Vsebina odgovora se ne pošlje.
Operativno priporočilo: Uporabno pri dejanjih, ki morajo počistiti ali ponastaviti trenutno stanje vnosa.
Strežnik je izpolnil veljavno zahtevo za obseg in vrne samo zahtevani obseg ali obsege bajtov. Content-Range opisuje dostavljene podatke.
Operativno priporočilo: Preverite, ali se vrednosti Range in Content-Range ujemajo; pogosto se uporablja za nadaljevanje prenosa predstavnosti ali datotek.
Odgovor WebDAV navaja ločene rezultate za več virov ali podoperacij, običajno v strukturiranem telesu XML.
Operativno priporočilo: Razložite rezultat vsakega vdelanega vira; zunanje stanje samo po sebi ne pove celotnega izida.
Odgovor WebDAV multistatus izpusti člane, ki so že navedeni prej v istem odgovoru, da jih ne bi ponavljal.
Operativno priporočilo: Značilno za WebDAV; razlagajte skupaj s celotnim odgovorom multistatus.
Strežnik je izvedel GET z uporabo manipulacij instance in vrnil predstavitev, izpeljano iz trenutnega vira v skladu z dogovorjenim mehanizmom delta.
Operativno priporočilo: Specializirano kodiranje delta; odjemalci in strežniki se morajo dogovoriti o pretvorbi.
Cilj ima več predstavitev ali lokacij, odgovor pa ponuja izbiro. Odjemalec ali uporabnik lahko izbere prednostno različico.
Operativno priporočilo: Navedite jasne možnosti; ne predpostavljajte, da bo vsak odjemalec izbral samodejno.
Vir ima nov trajni URI. Odjemalci lahko posodobijo shranjene povezave in predpomnilnike, zato to uporabite samo, kadar naj bo premik trajen.
Operativno priporočilo: Pri selitvah SEO preusmerite neposredno na končni enakovredni URL in posodobite notranje povezave.
Vir je začasno na voljo na drugem URI-ju. Zgodovinsko vedenje v nekaterih primerih dovoljuje spremembo metode, zato to ni najvarnejša izbira, kadar mora POST ostati POST.
Operativno priporočilo: Uporabite za začasne premike, kadar je sprememba metode sprejemljiva; sicer razmislite o 307.
Odjemalec naj z GET (ali po potrebi HEAD) pridobi vir, naveden v Location, namesto da ponovi prvotno dejanje. Pogosto se uporablja po oddaji obrazca.
Operativno priporočilo: Izvaja vzorec Post/Redirect/Get in preprečuje ponovno oddajo dejanja.
Pogojni GET ali HEAD sporoča, da je predpomnjena predstavitev še vedno aktualna. Odgovor nima telesa in odjemalcu omogoča ponovno uporabo shranjene kopije.
Operativno priporočilo: Vrnite samo, kadar se ujema validator, kot sta If-None-Match ali If-Modified-Since.
Zgodovinski odgovor je predlagal, naj odjemalec do vira dostopa prek proxyja. Zaradi varnostnih razlogov je zastarel in ga sodobne storitve ne smejo uporabljati.
Operativno priporočilo: Ne uvajajte; proxyje konfigurirajte zunaj pasu.
Ta vrednost je v sodobnih specifikacijah HTTP rezervirana oziroma neuporabljena. Za današnjo spletno aplikacijo nima standardnega operativnega pomena.
Operativno priporočilo: Ne pošiljajte je.
Vir je začasno na drugem URI-ju, odjemalec pa mora pri sledenju preusmeritvi ohraniti prvotno metodo in telo.
Operativno priporočilo: Uporabite, kadar se začasni premik ne sme spremeniti iz POST v GET.
Vir je bil trajno premaknjen, odjemalec pa mora pri sledenju preusmeritvi ohraniti prvotno metodo in telo.
Operativno priporočilo: Uporabite za trajne premike, kadar je pomembno ohraniti metodo; posodobite canonical in notranje reference.
Strežnik zahteve ne more obdelati, ker so njena sintaksa, okvirjanje ali poslani podatki neveljavni. Ponovitev enake zahteve verjetno ne bo pomagala.
Operativno priporočilo: Preverite kodiranje URL-ja, sintakso JSON-a ali telesa, zahtevana polja in okvirjanje zahteve.
Zahteva nima veljavnih poverilnic za cilj. Kljub imenu ta odgovor pomeni, da je potrebna avtentikacija ali da je ta spodletela.
Operativno priporočilo: Pošljite pričakovane poverilnice in vključite izziv WWW-Authenticate.
Rezervirano za prihodnjo uporabo, čeprav ga nekateri izdelki uporabljajo za plačila ali kvote. Ni enotnega, splošno interoperabilnega vedenja za plačila.
Operativno priporočilo: Pomen ponudnika obravnavajte kot specifičen in dokumentirajte pogodbo API-ja.
Strežnik je zahtevo razumel, vendar je ne želi izpolniti. Veljavne poverilnice ne spremenijo nujno izida, saj je omejitev lahko določena s pravilnikom.
Operativno priporočilo: Preverite dovoljenja, pravilnik dostopa, pravila IP/WAF in avtorizacijo na ravni vira.
Strežnik ne more najti trenutne predstavitve zahtevanega URI-ja ali ne želi razkriti, ali obstaja. Sam odgovor ne pove, ali je odsotnost začasna ali trajna.
Operativno priporočilo: Popravite URL, obnovite vir ali uporabite 410, kadar je znano, da je odstranitev trajna.
Vir obstaja, vendar ne podpira metode, uporabljene v tej zahtevi.
Operativno priporočilo: Vrnite glavo Allow s seznamom metod, ki jih vir sprejema.
Strežnik ne more ustvariti predstavitve, ki bi ustrezala proaktivnim željam odjemalca v glavi Accept.
Operativno priporočilo: Sprostite omejitve Accept ali nastavite ustrezno predstavitev oziroma pravilnik pogajanja.
Vmesni proxy zahteva poverilnice, preden posreduje zahtevo.
Operativno priporočilo: Avtenticirajte se pri proxyju z Proxy-Authenticate / Proxy-Authorization; to se razlikuje od avtentikacije pri izvornem strežniku.
Strežnik v času, ki ga je bil pripravljen čakati, ni prejel celotne zahteve. Odjemalec lahko poskusi znova prek nove povezave.
Operativno priporočilo: Preverite prekinitve omrežja, velikost prenosa ter časovne omejitve strežnika/proxyja.
Zahteva je v nasprotju s trenutnim stanjem vira, na primer zaradi trka različic ali poskusa ustvarjanja dvojnika.
Operativno priporočilo: Pojasnite spor in odjemalcu zagotovite dovolj trenutnega stanja za njegovo razrešitev.
Vir je namerno in verjetno trajno nedostopen, zanj pa ni znane zamenjave. To je močnejše od splošnega odgovora »ni najdeno«.
Operativno priporočilo: Uporabite, kadar je odstranitev namerna; odstranite zastarele notranje povezave in reference.
Strežnik zahteva glavo Content-Length, vendar je zahteva ni vsebovala.
Operativno priporočilo: Pošljite pravilno vrednost Content-Length ali uporabite podprto okvirjanje prenosa.
Pogoj zahteve, kot je If-Match, je bil ovrednoten kot neresničen, zato strežnik ni izvedel zahtevanega dejanja.
Operativno priporočilo: Osvežite predstavitev in poskusite znova z aktualnimi validatorji oziroma stanjem.
Telo zahteve presega omejitev, ki jo strežnik lahko ali želi obdelati. Strežnik lahko zapre povezavo ali dovoli nov poskus po zmanjšanju telesa.
Operativno priporočilo: Zmanjšajte velikost vsebine ali prilagodite dokumentirane omejitve nalaganja.
Cilj zahteve je daljši, kot ga je strežnik pripravljen razčleniti, pogosto zaradi predolgega poizvedbenega niza.
Operativno priporočilo: Uporabite krajši URI ali primerne podatke premaknite v telo zahteve.
Strežnik zavrne telo zahteve, ker vrsta predstavnosti, kodiranje vsebine ali pregledani format ni podprt.
Operativno priporočilo: Pošljite podprt Content-Type/kodiranje in telo, ki mu ustreza.
Zahtevanega obsega bajtov ni mogoče posredovati, na primer če se začne za koncem predstavitve.
Operativno priporočilo: Znova preverite dolžino vira in enote obsega; strežnik lahko vrne Content-Range: bytes */length.
Strežnik ali vmesni sistem ne more izpolniti pričakovanja, navedenega v glavi Expect.
Operativno priporočilo: Kadar je varno in primerno, poskusite znova brez nepodprtega pričakovanja.
Humoristična koda stanja iz prvomajske specifikacije. Ni običajna pogodba o napaki aplikacije, čeprav jo nekatere storitve uporabljajo za šalo.
Operativno priporočilo: Ne zanašajte se nanjo pri interoperabilnem delovanju v produkciji.
Zahteva je prispela do strežnika, ki ne more ustvariti avtoritativnega odgovora za ciljni URI, pogosto zaradi neusklajenega usmerjanja povezave ali avtoritete HTTP.
Operativno priporočilo: Poskusite znova prek ustrezne povezave ter preverite Host/:authority, SNI in usmerjanje proxyja.
Vrsta vsebine in sintaksa sta razumljeni, vendar strežnik ne more uporabiti navodil ali potrditi poslane vsebine.
Operativno priporočilo: Vrnite uporabne podrobnosti preverjanja za posamezna polja; popravek vsebine lahko omogoči uspeh.
Vir WebDAV je zaklenjen, zato zahtevane metode ni mogoče izvesti, dokler se stanje zaklepa ne razreši.
Operativno priporočilo: Preverite lastništvo zaklepa, časovno omejitev in ravnanje z žetonom zaklepa WebDAV.
Operacija WebDAV ni uspela, ker predhodna obvezna operacija v istem zaporedju zahteve ni uspela.
Operativno priporočilo: Pred ponovnim poskusom odvisnih operacij odpravite napako predhodnega dejanja.
Strežnik zavrne obdelavo zahteve, ki je bila morda ponovljena med zgodnjimi podatki, da zmanjša tveganje ponovitve.
Operativno priporočilo: Ko je povezava vzpostavljena brez zgodnjih podatkov, poskusite znova.
Strežnik zavrača trenutni protokol in sporoča, da naj odjemalec preklopi na drugega.
Operativno priporočilo: Vključite glavo Upgrade z opisom podprtih protokolov.
Strežnik zahteva pogojno zahtevo za preprečevanje izgubljenih posodobitev, odjemalec pa je poslal brezpogojno.
Operativno priporočilo: Pridobite trenutno stanje in pošljite ustrezen pogoj, kot je If-Match.
Odjemalec je v določenem obdobju poslal preveč zahtev glede na omejitev hitrosti, ki jo določa strežnik.
Operativno priporočilo: Upočasnite pošiljanje, upoštevajte Retry-After, kadar je naveden, in preprečite sočasne valove ponovnih poskusov.
Strežnik zahteve ne bo obdelal, ker je eno ali več polj glave ali celoten nabor glav prevelik.
Operativno priporočilo: Zmanjšajte piškotke/lastne glave ali prilagodite namerno nastavljeno omejitev strežnika.
Strežnik ne more zagotoviti zahtevanega vira zaradi pravne omejitve.
Operativno priporočilo: Kadar je primerno, pojasnite omejitev in njen obseg, ne da bi razkrili zaščitene informacije.
Strežnik je naletel na nepričakovano stanje in ne more dokončati zahteve. Gre za splošno rezervno napako, kadar ni primernejše napake strežnika.
Operativno priporočilo: Povežite zahtevo s strežniškimi dnevniki in obiskovalcem ne razkrivajte sledi sklada.
Strežnik ne podpira funkcije, potrebne za izpolnitev zahteve, običajno neimplementirane metode ali zmogljivosti.
Operativno priporočilo: Implementirajte funkcijo ali uporabite podprto metodo; koda ni namenjena začasni preobremenitvi.
Strežnik, ki deluje kot prehod ali proxy, je prejel neveljaven odgovor od nadrejenega strežnika.
Operativno priporočilo: Preverite stanje nadrejenega strežnika, nastavitve protokola/TLS, DNS in dnevnike proxyja.
Strežnik začasno ne more obdelati zahteve, pogosto zaradi vzdrževanja ali preobremenitve.
Operativno priporočilo: Če je mogoče, navedite Retry-After, koristen odgovor in pravila predpomnjenja za začasno napako.
Prehod ali proxy ni pravočasno prejel odgovora od nadrejene storitve.
Operativno priporočilo: Raziščite zakasnitev nadrejene storitve, omrežne poti in časovne omejitve po celotni verigi.
Strežnik ne podpira glavne različice HTTP, uporabljene v zahtevi.
Operativno priporočilo: Uporabite podprto različico protokola ali posodobite konfiguracijo strežnika/proxyja.
Napaka konfiguracije strežnika je ustvarila krožno pogajanje o vsebini, pri katerem izbrana različica znova začne pogajanje.
Operativno priporočilo: Popravite konfiguracijo različice in pogajanja; napaka je na izvornem strežniku.
Strežnik WebDAV ne more shraniti predstavitve, potrebne za dokončanje operacije.
Operativno priporočilo: Pred ponovnim poskusom sprostite ali zagotovite prostor in preverite kvote.
Strežnik je pri obdelavi zahteve zaznal neskončno zanko, pogosto med prehajanjem povezav WebDAV.
Operativno priporočilo: Prekinite ciklično povezavo med viri ali pravilo obdelave, ki ustvarja zanko.
Zahteva potrebuje razširitev, ki je strežnik ne podpira.
Operativno priporočilo: Uporabite podprt nabor razširitev ali se dogovorite za drugo možnost.
Odjemalec se mora avtenticirati za dostop do omrežja, običajno prek prestreznega portala. Namenjen je omrežnim posrednikom, ne prijavi na izvornem spletnem mestu.
Operativno priporočilo: Dokončajte avtentikacijo za dostop do omrežja in nato ponovite prvotno zahtevo.
Te vrednosti se pojavljajo v posameznih izdelkih, strežniških dnevnikih, CDN-jih ali aplikacijah. Niso zamenljive z registriranimi standardnimi pomeni; preverite pogoje storitve, ki jih ustvari.
Nekatere aplikacije uporabljajo to oznako, ko poteče avtentikacijska seja. Ne gre za splošno dodeljeno stanje HTTP, zato odjemalci ne morejo pričakovati enotne semantike.
Operativno priporočilo: Obnovite avtentikacijo v skladu s pogoji storitve.
Odgovor, značilen za ponudnika, ki se je zgodovinsko uporabljal za omejevanje zahtev. Njegov pomen določa implementacija.
Operativno priporočilo: Upoštevajte dokumentirana navodila za omejevanje hitrosti.
Nekateri strežniki zaprejo povezavo, ne da bi poslali običajen odgovor, pogosto kot ukrep filtriranja.
Operativno priporočilo: Preverite dnevnike ponudnika; odjemalci lahko prikažejo omrežno napako namesto te kode.
Microsoftova razširitev, ki jo nekatere storitve uporabljajo, da odjemalca pozovejo k ponovitvi zahteve z dodatnimi informacijami.
Operativno priporočilo: Upoštevajte dokumentacijo posameznega API-ja.
Povratni proxy lahko to zabeleži, ko se odjemalec odklopi, preden je odgovor nadrejenega strežnika dokončan. Običajno gre za klasifikacijo v dnevniku, ne za odgovor, dostavljen odjemalcu.
Operativno priporočilo: Raziščite preklice odjemalcev in počasne zahteve nadrejenemu strežniku.
Nekatere platforme gostovanja to kodo uporabljajo za kvoto ali omejitev pasovne širine. V HTTP nima splošnega interoperabilnega pomena.
Operativno priporočilo: Preverite kvoto gostitelja in nastavitve obračunavanja.
CDN ali proxy to lahko uporabi, ko prejme nepričakovan ali prazen odgovor izvornega strežnika.
Operativno priporočilo: Primerjajte dnevnike roba omrežja in izvora; preverite, ali izvorni strežnik oddaja veljaven odgovor HTTP.
Proxy ni mogel vzpostaviti povezave z izvornim strežnikom ali pa je izvorni strežnik povezavo zavrnil.
Operativno priporočilo: Preverite razpoložljivost izvora, pravila požarnega zidu in sezname dovoljenih naslovov proxyja.
Storitev na robu omrežja se je povezala ali poskušala povezati z izvorom, vendar se izmenjava ni končala v predvidenem času.
Operativno priporočilo: Preverite odzivnost izvora in omrežno zakasnitev.
Proxy ni mogel doseči konfiguriranega naslova izvora.
Operativno priporočilo: Preverite razreševanje DNS, usmerjanje in konfiguracijo IP-ja izvora.
Povezava z izvorom je uspela, vendar izvor ni pravočasno poslal odgovora HTTP.
Operativno priporočilo: Skrajšajte čas obdelave izvora ali prilagodite podprte nastavitve časovne omejitve.
Proxy ni mogel dokončati pogajanja TLS z izvornim strežnikom.
Operativno priporočilo: Preverite certifikate, združljivost protokolov in šifer ter SNI.
Vmesni sistem je med preverjanjem zavrnil certifikat izvora.
Operativno priporočilo: Namestite veljaven, pravilno imenovan, zaupanja vreden in še veljaven certifikat s celotno verigo.
Zastarelo stanje proxyja, značilno za ponudnika, ki označuje napako povezave za pospeševanje izvora.
Operativno priporočilo: Preverite povezovalnik in pot do izvora, značilna za ponudnika.
Nekateri odjemalci ali proxyji to vrednost uporabljajo za opis časovne omejitve pri branju iz omrežja. V HTTP nima univerzalnega pomena.
Operativno priporočilo: Preglejte diagnostiko odjemalca/proxyja.
Nekateri proxyji to vrednost uporabljajo, ko poteče čas poskusa vzpostavitve omrežne povezave. Pomen je odvisen od implementacije.
Operativno priporočilo: Preverite dosegljivost in nastavitve časovne omejitve.
Pri trajnem premiku URL-ja uporabite trajno preusmeritev samo, kadar naj cilj nadomesti stari URL; za začasno spremembo izberite začasni odgovor. Verige naj bodo kratke in naj vodijo do končnega enakovrednega cilja. Preverite, ali je mogoče razrešiti vsako vrednost Location, ali je končni odgovor ustrezen ter ali se oznake canonical in notranje povezave ujemajo s predvidenim URL-jem. Končni odgovor 2xx potrjuje uspeh HTTP, ne pa, da je stran koristna, indeksabilna ali tehnično brezhibna.
Ta stran povzema semantiko kod stanja HTTP za praktično uporabo. Register standardov in RFC sta avtoritativna vira za standardizirane kode; MDN ponuja dostopen tehnični priročnik, Wikipedia pa je dopolnilni pregled, ki ga vzdržuje skupnost.