HTTP statusni kodovi

Poslužitelj je prihvatio zaglavlja zahtjeva i čeka ostatak tijela zahtjeva. Često se koristi uz Expect: 100-continue kako bi klijent izbjegao slanje velikog tijela ako bi zahtjev bio odbijen.

Operativne smjernice: Privremeni odgovor; nastavite slati tijelo samo kada se ono očekuje.

Poslužitelj pristaje promijeniti protokol za ovu vezu nakon što klijent zatraži nadogradnju. WebSocket rukovanje uspostavom veze čest je primjer.

Operativne smjernice: Prijelaz na razini veze; provjerite zaglavlja Upgrade i Connection.

WebDAV poslužitelj izvještava da je započeo dugotrajnu radnju koja još nije dovršena. Riječ je o starom/zastarjelom odgovoru koji se ne smije zamijeniti s konačnim rezultatom.

Operativne smjernice: Privremeni WebDAV status; pričekajte konačni odgovor.

Poslužitelj šalje početna zaglavlja, često Link naznake, dok priprema konačni odgovor. Klijent može ranije početi dohvaćati vjerojatno ključne resurse.

Operativne smjernice: Privremena optimizacija; nakon nje mora uslijediti konačni odgovor.

Zahtjev je uspio. Reprezentacija ovisi o metodi: GET vraća resurs, HEAD vraća metapodatke bez tijela, a radnja pisanja može vratiti prikaz rezultata.

Operativne smjernice: Koristite kada je zahtjev dovršen i kada je primjeren prikaz reprezentacije odgovora.

Zahtjev je dovršen i stvorio je jedan ili više resursa. Odgovor bi trebao identificirati novi resurs, najčešće zaglavljem Location, a može vratiti i njegov prikaz.

Operativne smjernice: Često nakon POST-a ili PUT-a; osigurajte da se stvoreni resurs može pronaći.

Poslužitelj je prihvatio zahtjev za obradu, ali obrada nije završena i još uvijek može ne uspjeti. HTTP naknadno ne šalje drugi odgovor za istu razmjenu.

Operativne smjernice: Navedite URL za provjeru radnje/statusa ili drugi način utvrđivanja konačnog ishoda.

Proxy ili posrednik koji mijenja sadržaj vratio je metapodatke ili sadržaj koji se razlikuje od izvornog odgovora. To znači da odgovor nije izravan autoritativni prikaz.

Operativne smjernice: Koristite samo kada je promjena posrednika relevantna.

Zahtjev je uspio i nema sadržaja odgovora za slanje. Zaglavlja i dalje mogu sadržavati korisne metapodatke, primjerice ažurirane validatore.

Operativne smjernice: Nemojte uključiti tijelo odgovora.

Zahtjev je uspio, a klijentu se nalaže da poništi prikaz ili obrazac iz kojeg je poslan. Ne šalje se sadržaj odgovora.

Operativne smjernice: Korisno za radnje koje trebaju očistiti ili poništiti trenutačno stanje unosa.

Poslužitelj je ispunio valjani zahtjev za raspon i vraća samo zatraženi raspon bajtova ili raspone. Content-Range opisuje što je isporučeno.

Operativne smjernice: Provjerite podudaraju li se vrijednosti Range i Content-Range; često se koristi za nastavak preuzimanja medija i datoteka.

WebDAV odgovor izvještava o zasebnim rezultatima za više resursa ili podradnji, obično u strukturiranom XML tijelu.

Operativne smjernice: Tumačite rezultat za svaki ugrađeni resurs; vanjski status sam po sebi ne prikazuje cijeli ishod.

WebDAV odgovor s više statusa izostavlja članove koji su već navedeni ranije u istom odgovoru kako ih ne bi ponavljao.

Operativne smjernice: Specifično za WebDAV; tumačite zajedno s okolnim odgovorom koji sadrži više statusa.

Poslužitelj je ispunio GET primjenom manipulacija instancom i vraća prikaz izveden iz trenutačnog resursa prema dogovorenom delta mehanizmu.

Operativne smjernice: Specijalizirano delta kodiranje; klijenti i poslužitelji moraju se dogovoriti o transformaciji.

Cilj ima više prikaza ili odredišta, a odgovor nudi izbor. Klijent ili korisnik može odabrati željenu varijantu.

Operativne smjernice: Navedite jasne alternative; nemojte pretpostaviti da će svaki klijent automatski odabrati jednu.

Resurs ima novu URI adresu koja vrijedi trajno. Klijenti mogu ažurirati spremljene poveznice i predmemoriju, stoga kod koristite samo kada je premještanje namijenjeno trajanju.

Operativne smjernice: Kod SEO migracija izravno preusmjerite na konačni istovrijedni URL i ažurirajte interne poveznice.

Resurs je privremeno dostupan na drugoj URI adresi. Povijesno ponašanje u nekim slučajevima dopušta promjenu metode pa ovo nije najsigurniji izbor kada POST mora ostati POST.

Operativne smjernice: Koristite za privremena premještanja kada je prihvatljiva promjena metode; ako nije, razmotrite 307.

Klijent bi trebao dohvatiti resurs naveden u zaglavlju Location metodom GET (ili HEAD kada je primjereno), umjesto ponavljanja izvorne radnje. Često se koristi nakon slanja obrasca.

Operativne smjernice: Primjenjuje obrazac Post/Redirect/Get i sprječava ponovno slanje radnje.

Uvjetni GET ili HEAD pokazuje da je predmemorirani prikaz i dalje aktualan. Odgovor nema tijelo pa klijent može ponovno koristiti spremljenu kopiju.

Operativne smjernice: Vratite samo kada se podudara validator poput If-None-Match ili If-Modified-Since.

Povijesni odgovor predlagao je pristup resursu putem proxyja. Zastarjel je iz sigurnosnih razloga i ne bi se trebao koristiti u suvremenim uslugama.

Operativne smjernice: Nemojte ga primjenjivati; proxyje konfigurirajte zasebnim kanalom.

Ova je vrijednost rezervirana ili se ne koristi u suvremenim HTTP specifikacijama. Nema standardno operativno značenje za aktualnu web-aplikaciju.

Operativne smjernice: Nemojte je slati.

Resurs je privremeno na drugoj URI adresi, a klijent mora sačuvati izvornu metodu i tijelo zahtjeva pri praćenju preusmjeravanja.

Operativne smjernice: Koristite kada privremeno premještanje ne smije pretvoriti POST u GET.

Resurs je trajno premješten, a klijent pri praćenju preusmjeravanja mora sačuvati izvornu metodu i tijelo zahtjeva.

Operativne smjernice: Koristite za trajna premještanja kada je očuvanje metode važno; ažurirajte canonical i interne reference.

Poslužitelj ne može obraditi zahtjev jer su njegov sintaksa, uokvirivanje ili poslani podaci nevaljani. Ponavljanje istog neizmijenjenog zahtjeva vjerojatno neće pomoći.

Operativne smjernice: Provjerite kodiranje URL-a, sintaksu JSON-a/tijela, obvezna polja i uokvirivanje zahtjeva.

Zahtjevu nedostaju valjani vjerodajni podaci za autentifikaciju cilja. Unatoč nazivu, ovaj odgovor znači da je autentifikacija potrebna ili nije uspjela.

Operativne smjernice: Pošaljite očekivane vjerodajnice i uključite izazov WWW-Authenticate.

Rezervirano za buduću uporabu, iako ga neki proizvodi koriste za naplatu ili kvote. Ne postoji jedinstveno univerzalno interoperabilno ponašanje za plaćanje.

Operativne smjernice: Vendor-specifična značenja tretirajte kao takva i dokumentirajte ugovor API-ja.

Poslužitelj je razumio zahtjev, ali ga odbija izvršiti. Valjane vjerodajnice ne moraju promijeniti ishod jer ograničenje može biti utemeljeno na pravilima.

Operativne smjernice: Provjerite dozvole, pravila pristupa, IP/WAF pravila i autorizaciju na razini resursa.

Poslužitelj ne može pronaći trenutačni prikaz tražene URI adrese ili ne želi otkriti postoji li. Sam odgovor ne govori je li nedostupnost privremena ili trajna.

Operativne smjernice: Ispravite URL, vratite resurs ili upotrijebite 410 ako je poznato da je trajno uklonjen.

Resurs postoji, ali ne podržava metodu upotrijebljenu u ovom zahtjevu.

Operativne smjernice: Vratite zaglavlje Allow s popisom metoda koje resurs prihvaća.

Poslužitelj ne može proizvesti prikaz koji odgovara aktivnim postavkama Accept klijenta.

Operativne smjernice: Ublažite ograničenja Accept ili konfigurirajte odgovarajuće prikaze/pravila pregovaranja.

Posrednički proxy zahtijeva vjerodajnice prije prosljeđivanja zahtjeva.

Operativne smjernice: Autentificirajte se proxyju pomoću Proxy-Authenticate / Proxy-Authorization; to se razlikuje od autentifikacije izvornog poslužitelja.

Poslužitelj nije primio cijeli zahtjev unutar vremena koje je bio spreman čekati. Klijent može pokušati ponovno na novoj vezi.

Operativne smjernice: Provjerite zastoje mreže, veličinu prijenosa i postavke isteka vremena poslužitelja/proxyja.

Zahtjev je u sukobu s trenutačnim stanjem resursa, primjerice zbog sukoba verzija ili pokušaja stvaranja duplikata.

Operativne smjernice: Objasnite sukob i pružite dovoljno podataka o trenutačnom stanju da ga klijent može riješiti.

Resurs je namjerno i vjerojatno trajno nedostupan, bez poznate zamjene. To je snažnija poruka od općeg odgovora „nije pronađeno”.

Operativne smjernice: Koristite kada je uklanjanje namjerno; uklonite zastarjele interne poveznice i reference.

Poslužitelj zahtijeva zaglavlje Content-Length, ali ga zahtjev nije sadržavao.

Operativne smjernice: Pošaljite točnu vrijednost Content-Length ili upotrijebite podržano uokvirivanje prijenosa.

Uvjet zahtjeva, poput If-Match, procijenjen je kao netočan pa poslužitelj nije izvršio zatraženu radnju.

Operativne smjernice: Osvježite prikaz i pokušajte ponovno s aktualnim validatorima ili stanjem.

Tijelo zahtjeva premašuje ograničenje koje poslužitelj želi ili može obraditi. Poslužitelj može zatvoriti vezu ili dopustiti ponovni pokušaj nakon smanjenja tijela.

Operativne smjernice: Smanjite veličinu podataka ili prilagodite dokumentirana ograničenja prijenosa.

Cilj zahtjeva dulji je nego što ga je poslužitelj spreman tumačiti, često zbog predugog niza upita.

Operativne smjernice: Upotrijebite kraći URI ili prikladne podatke premjestite u tijelo zahtjeva.

Poslužitelj odbija tijelo zahtjeva jer vrsta medija, kodiranje sadržaja ili pregledani format nisu podržani.

Operativne smjernice: Pošaljite podržani Content-Type/kodiranje i tijelo koje mu odgovara.

Traženi raspon bajtova nije moguće isporučiti, primjerice jer počinje nakon duljine prikaza.

Operativne smjernice: Ponovno provjerite duljinu resursa i jedinice raspona; poslužitelji mogu vratiti Content-Range: bytes */duljina.

Poslužitelj ili posrednik ne može ispuniti očekivanje navedeno u zaglavlju Expect.

Operativne smjernice: Pokušajte ponovno bez nepodržanog očekivanja kada je to sigurno i primjereno.

Riječ je o šaljivom statusu koji potječe iz specifikacije objavljene za Prvi april. Ne predstavlja uobičajeni ugovor o pogreškama aplikacije, iako ga neke usluge koriste u šali.

Operativne smjernice: Nemojte se oslanjati na njega za interoperabilno ponašanje u produkciji.

Zahtjev je stigao do poslužitelja koji ne može dati mjerodavan odgovor za ciljni URI, često zato što usmjeravanje veze ili HTTP autoritet ne odgovara.

Operativne smjernice: Pokušajte ponovno putem odgovarajuće veze te provjerite Host/:authority, SNI i usmjeravanje proxyja.

Vrsta sadržaja i sintaksa su prepoznate, ali poslužitelj ne može primijeniti upute ni potvrditi valjanost poslanog sadržaja.

Operativne smjernice: Navedite konkretne pojedinosti o provjeri valjanosti pojedinih polja; ispravak sadržaja zahtjeva može omogućiti uspjeh.

Resurs WebDAV-a zaključan je pa se tražena metoda ne može izvršiti dok se ne riješi stanje zaključavanja.

Operativne smjernice: Provjerite vlasništvo nad zaključavanjem, vremensko ograničenje i obradu tokena za zaključavanje WebDAV-a.

Operacija WebDAV-a nije uspjela jer je prethodna potrebna operacija u istom nizu zahtjeva neuspjela.

Operativne smjernice: Riješite prethodnu neuspjelu radnju prije ponavljanja ovisnih operacija.

Poslužitelj odbija obraditi zahtjev koji je možda ponovno poslan tijekom ranih podataka, kako bi smanjio rizik ponovne reprodukcije.

Operativne smjernice: Pokušajte ponovno nakon uspostave veze, bez ranih podataka.

Poslužitelj odbija trenutačni protokol i upućuje klijenta da prijeđe na drugi.

Operativne smjernice: Navedite zaglavlje Upgrade s opisom podržanih protokola.

Poslužitelj zahtijeva uvjetni zahtjev radi sprječavanja izgubljenih izmjena, ali klijent je poslao bezuvjetni zahtjev.

Operativne smjernice: Dohvatite trenutačno stanje i pošaljite odgovarajući uvjet, primjerice If-Match.

Klijent je u određenom razdoblju poslao previše zahtjeva prema ograničenju brzine koje definira poslužitelj.

Operativne smjernice: Usporite ponovne pokušaje, poštujte Retry-After ako postoji i izbjegavajte istodobne nalete ponovljenih zahtjeva.

Poslužitelj neće obraditi zahtjev jer je jedno ili više polja zaglavlja, odnosno njihov ukupni skup, prevelik.

Operativne smjernice: Smanjite kolačiće ili prilagođena zaglavlja ili prilagodite namjerno postavljeno ograničenje poslužitelja.

Poslužitelj ne može pružiti traženi resurs zbog pravnog ograničenja.

Operativne smjernice: Kad je primjereno, objasnite ograničenje i njegov opseg bez otkrivanja zaštićenih podataka.

Poslužitelj je naišao na neočekivano stanje i ne može dovršiti zahtjev. Riječ je o općoj zamjenskoj pogrešci kada nije primjenjiva preciznija pogreška poslužitelja.

Operativne smjernice: Povežite zahtjev sa zapisima poslužitelja i nemojte posjetiteljima otkrivati tragove stoga poziva.

Poslužitelj ne podržava funkcionalnost potrebnu za ispunjenje zahtjeva, najčešće neimplementiranu metodu ili mogućnost.

Operativne smjernice: Implementirajte tu mogućnost ili upotrijebite podržanu metodu; ovaj status nije namijenjen privremenom preopterećenju.

Poslužitelj koji djeluje kao pristupnik ili proxy primio je nevaljan odgovor od uzvodnog poslužitelja.

Operativne smjernice: Provjerite stanje uzvodne usluge, postavke protokola i TLS-a, DNS te zapisnike proxyja.

Poslužitelj privremeno ne može obraditi zahtjev, često zbog održavanja ili preopterećenja.

Operativne smjernice: Ako je moguće, navedite Retry-After, korisnu poruku i pravila predmemoriranja primjerena privremenom kvaru.

Pristupnik ili proxy nije pravodobno primio odgovor uzvodne usluge.

Operativne smjernice: Istražite kašnjenje uzvodne usluge, mrežne putove i vremenska ograničenja duž cijelog niza.

Poslužitelj ne podržava glavnu verziju HTTP-a korištenu u zahtjevu.

Operativne smjernice: Upotrijebite podržanu verziju protokola ili ažurirajte konfiguraciju poslužitelja/proxyja.

Pogreška konfiguracije poslužitelja stvorila je kružnu konfiguraciju pregovaranja o sadržaju u kojoj odabrana varijanta ponovno pokreće pregovaranje.

Operativne smjernice: Ispravite konfiguraciju varijanti/pregovaranja; riječ je o pogrešci na izvornoj strani.

Poslužitelj WebDAV-a ne može pohraniti prikaz potreban za dovršetak operacije.

Operativne smjernice: Oslobodite ili dodijelite prostor za pohranu i provjerite kvote prije ponovnog pokušaja.

Poslužitelj je otkrio beskonačnu petlju tijekom obrade zahtjeva, često pri obilasku WebDAV veza.

Operativne smjernice: Prekinite cikličku vezu resursa ili pravilo obrade.

Zahtjev zahtijeva proširenje koje poslužitelj ne podržava.

Operativne smjernice: Upotrijebite podržani skup proširenja ili dogovorite alternativu.

Klijent se mora autentificirati kako bi dobio pristup mreži, obično putem zarobljenog portala. Status je namijenjen mrežnim posrednicima, a ne prijavi na izvornom web-mjestu.

Operativne smjernice: Dovršite autentifikaciju za pristup mreži, a zatim ponovite izvorni zahtjev.

Neke aplikacije koriste ovu oznaku kada istekne sesija autentifikacije. Nije riječ o univerzalno dodijeljenom HTTP statusu pa klijenti ne mogu očekivati dosljedno značenje.

Operativne smjernice: Obnovite autentifikaciju u skladu s ugovorom usluge.

Odgovor specifičan za dobavljača koji se povijesno koristio za ograničavanje brzine. Značenje ovisi o implementaciji.

Operativne smjernice: Slijedite dokumentirane smjernice za ograničenje brzine.

Neki poslužitelji zatvaraju vezu bez slanja uobičajenog odgovora, često kao mjeru filtriranja.

Operativne smjernice: Provjerite zapisnike pružatelja; klijenti mogu prijaviti mrežnu pogrešku umjesto prikazivanja ovog koda.

Microsoftovo proširenje koje neke usluge koriste kako bi zatražile da klijent ponovi zahtjev s dodatnim informacijama.

Operativne smjernice: Slijedite dokumentaciju odgovarajućeg API-ja.

Obrnuti proxy može zabilježiti ovaj status ako se klijent odspoji prije dovršetka odgovora uzvodnog poslužitelja. Obično je riječ o klasifikaciji u zapisniku, a ne o odgovoru isporučenom tom klijentu.

Operativne smjernice: Istražite otkazivanja klijenta i spore uzvodne zahtjeve.

Neke platforme za hosting koriste ovaj kod za kvotu ili ograničenje propusnosti. Nema opće interoperabilno značenje u HTTP-u.

Operativne smjernice: Provjerite kvotu i postavke naplate kod pružatelja hostinga.

CDN ili proxy može upotrijebiti ovaj status kada primi neočekivan ili prazan odgovor izvornog poslužitelja.

Operativne smjernice: Usporedite zapisnike rubnog i izvornog poslužitelja; provjerite šalje li izvor valjan HTTP odgovor.

Proxy nije mogao uspostaviti vezu s izvornim poslužiteljem ili je izvor odbio vezu.

Operativne smjernice: Provjerite dostupnost izvora, pravila vatrozida i popise dopuštenih proxyja.

Rubna usluga povezala se s izvornim poslužiteljem ili je to pokušala, ali razmjena nije dovršena unutar zadanog vremena.

Operativne smjernice: Provjerite odziv izvornog poslužitelja i mrežno kašnjenje.

Proxy nije mogao dosegnuti konfiguriranu adresu izvornog poslužitelja.

Operativne smjernice: Provjerite DNS razrješavanje, usmjeravanje i IP konfiguraciju izvora.

Veza s izvornim poslužiteljem uspostavljena je, ali izvor nije poslao pravodoban HTTP odgovor.

Operativne smjernice: Smanjite vrijeme obrade na izvoru ili prilagodite podržane postavke vremenskog ograničenja.

Proxy nije uspio dovršiti TLS pregovaranje s izvornim poslužiteljem.

Operativne smjernice: Provjerite certifikate, kompatibilnost protokola i šifri te SNI.

Posrednik je odbio certifikat izvornog poslužitelja tijekom provjere.

Operativne smjernice: Instalirajte valjan, ispravno imenovan, pouzdan i važeći certifikat s potpunim lancem.

Naslijeđeni status proxyja specifičan za dobavljača prijavljuje pogrešku u vezi za ubrzavanje izvora.

Operativne smjernice: Provjerite konektor specifičan za pružatelja i put do izvora.

Neki klijenti ili proxyji koriste ovu vrijednost za opis isteka vremena čitanja mreže. Nema univerzalno značenje u HTTP-u.

Operativne smjernice: Pregledajte dijagnostiku klijenta/proxyja.

Neki proxyji koriste ovu vrijednost kada istekne vrijeme pokušaja uspostave mrežne veze. Značenje ovisi o implementaciji.

Operativne smjernice: Provjerite dostupnost i postavke vremenskog ograničenja.