HTTP vastuskoodid

Server on päringu päised vastu võtnud ja ootab ülejäänud päringukeha. Seda kasutatakse sageli koos päisega Expect: 100-continue, et klient saaks vältida suure keha üleslaadimist, kui päring tagasi lükatakse.

Tegevusjuhised: Vahevastus; jätka päringukeha saatmist ainult siis, kui seda oodatakse.

Server nõustub pärast kliendi uuendustaotlust selle ühenduse protokolli vahetama. Tuntud näide on WebSocketi käepigistus.

Tegevusjuhised: Ühenduse taseme üleminek; kontrolli Upgrade- ja Connection-päiseid.

WebDAV-server teatab, et pikaajaline toiming on alanud, kuid pole veel lõppenud. See on pärand-/aegunud vastus ning seda ei tohiks pidada lõpptulemuseks.

Tegevusjuhised: WebDAV-i vaheolek; oota lõplikku vastust.

Server saadab lõplikku vastust ette valmistades esialgsed päised, sageli Link-vihjed. Klient võib tõenäoliselt vajalikke ressursse varem laadima hakata.

Tegevusjuhised: Vahepealne optimeerimine; sellele peab järgnema lõplik vastus.

Päring õnnestus. Esitatav vastus sõltub meetodist: GET tagastab ressursi, HEAD metaandmed ilma sisuta ning kirjutamistoiming võib tagastada tulemuse kirjelduse.

Tegevusjuhised: Kasuta lõpetatud päringu korral, kui vastuse sisu esitamine on asjakohane.

Päring lõpetati ning loodi üks või mitu ressurssi. Vastus peaks uue ressursi tuvastama, tavaliselt Location-päisega, ja võib tagastada ka selle esituse.

Tegevusjuhised: Tavaline POST- või PUT-päringu järel; veendu, et loodud ressurss oleks leitav.

Server võttis päringu töötlemiseks vastu, kuid töö pole lõppenud ja võib ebaõnnestuda. HTTP ei saada sama päringu kohta hiljem teist vastust.

Tegevusjuhised: Esita toimingu oleku-URL või muu võimalus lõpptulemuse teadasaamiseks.

Teisendav proxy või vahendaja tagastas lähte serveri vastusest erinevad metaandmed või sisu. See näitab, et vastus ei ole otsene autoriteetne esitus.

Tegevusjuhised: Kasuta ainult siis, kui vahendaja tehtud teisendus on oluline.

Päring õnnestus ja vastuse sisu pole saata. Päised võivad siiski sisaldada kasulikke metaandmeid, näiteks uuendatud kontrollväärtusi.

Tegevusjuhised: Ära lisa vastusekeha.

Päring õnnestus ja kliendile antakse juhis lähtestada päringu esitanud vaade või vorm. Vastuse sisu ei saadeta.

Tegevusjuhised: Kasulik toimingutes, mille järel tuleb praegune sisestusolek tühjendada või lähtestada.

Server täitis kehtiva vahemikupäringu ja tagastab ainult küsitud baidivahemiku või -vahemikud. Edastatud osa kirjeldab päis Content-Range.

Tegevusjuhised: Veendu, et Range- ja Content-Range-väärtused kattuvad; levinud jätkatavate meediafailide ja allalaadimiste puhul.

WebDAV-i vastus esitab eraldi tulemused mitme ressursi või alamtoimingu kohta, tavaliselt struktureeritud XML-kehas.

Tegevusjuhised: Tõlgenda iga sisestatud ressursi tulemust; väline olekukood üksi ei näita kogu tulemust.

WebDAV-i multistaatusvastus jätab samas vastuses varem loetletud liikmed kordamise vältimiseks välja.

Tegevusjuhised: WebDAV-i erijuht; tõlgenda seda koos ümbritseva multistaatusvastusega.

Server täitis GET-päringu eksemplarimanipulatsioonide abil ja tagastab läbiräägitud delta-mehhanismiga loodud esituse, mis põhineb praegusel ressursil.

Tegevusjuhised: Spetsiaalne delta-kodeering; klient ja server peavad teisenduses kokku leppima.

Sihtkohal on mitu esitust või asukohta ning vastus pakub valikuid. Klient või kasutaja saab valida sobiva variandi.

Tegevusjuhised: Esita selged alternatiivid; ära eelda, et iga klient teeb valiku automaatselt.

Ressursil on uus püsiv URI. Kliendid võivad salvestatud linke ja vahemälu uuendada, seega kasuta seda ainult siis, kui teisaldamine on mõeldud püsivana.

Tegevusjuhised: SEO jaoks tehtaval saidi kolimisel suuna otse lõplikule samaväärsele URL-ile ja uuenda siselinke.

Ressurss on ajutiselt saadaval teisel URI-l. Ajalooline käitumine lubab mõnel juhul meetodi muutmist, seega pole see ohutuim valik, kui POST peab jääma POST-iks.

Tegevusjuhised: Kasuta ajutiseks teisaldamiseks, kui meetodi muutmine on vastuvõetav; muul juhul kaalu 307-t.

Klient peaks kordama algse toimingu asemel GET-päringu (või vajaduse korral HEAD-päringu) Location-päises nimetatud ressursile. Seda kasutatakse sageli pärast vormi esitamist.

Tegevusjuhised: Rakendab Post/Redirect/Get-mustrit ja väldib toimingu uuesti esitamist.

Tingimuslik GET- või HEAD-päring näitab, et vahemällu salvestatud esitus on endiselt ajakohane. Vastusel pole keha ning klient saab kasutada salvestatud koopiat.

Tegevusjuhised: Tagasta ainult siis, kui kontrollväärtus, näiteks If-None-Match või If-Modified-Since, kattub.

Ajalooline vastus, mis soovitas kliendil kasutada ressursile juurdepääsuks proxyt. Turvakaalutlustel on see aegunud ja tänapäevased teenused ei tohiks seda kasutada.

Tegevusjuhised: Ära rakenda; seadista proxyd väljaspool HTTP vastust.

See väärtus on tänapäevastes HTTP spetsifikatsioonides reserveeritud või kasutamata. Praegusel veebirakendusel pole sellel standardset tegevuslikku tähendust.

Tegevusjuhised: Ära saada seda.

Ressurss asub ajutiselt teisel URI-l ning klient peab ümbersuunamisel säilitama algse meetodi ja keha.

Tegevusjuhised: Kasuta seda ajutisel teisaldamisel, kui POST-i muutmine GET-iks pole lubatud.

Ressurss on jäädavalt teisaldatud ning klient peab ümbersuunamisel säilitama algse meetodi ja keha.

Tegevusjuhised: Kasuta püsivaks teisaldamiseks, kui meetodi säilitamine on oluline; uuenda canonical- ja siselinkide viiteid.

Server ei saa päringut töödelda, sest selle süntaks, raamimine või esitatud andmed on vigased. Muutmata sama päringu kordamine tõenäoliselt ei aita.

Tegevusjuhised: Kontrolli URL-i kodeeringut, JSON-i/keha süntaksit, nõutud välju ja päringu raamimist.

Sihtkoha jaoks puuduvad päringus kehtivad autentimisandmed. Nimest hoolimata tähendab see vastus, et autentimine on nõutav või ebaõnnestus.

Tegevusjuhised: Saada oodatud autentimisandmed ning lisa WWW-Authenticate’i väljakutse.

Reserveeritud tulevaseks kasutuseks, kuigi mõni toode kasutab seda makse- või kvooditöövoogudes. Ühtset kõigi süsteemide vahel toimivat maksekäitumist pole määratud.

Tegevusjuhised: Käsitle pakkujapõhiseid tähendusi eraldi ja dokumenteeri API leping.

Server mõistis päringut, kuid keeldub seda täitmast. Kehtivad sisselogimisandmed ei pruugi tulemust muuta, sest piirang võib tuleneda eeskirjast.

Tegevusjuhised: Kontrolli õigusi, juurdepääsupoliitikat, IP/WAF-reegleid ja ressursitaseme autoriseerimist.

Server ei leia küsitud URI jaoks praegust esitust või ei soovi selle olemasolu avaldada. Vastus üksi ei ütle, kas puudumine on ajutine või püsiv.

Tegevusjuhised: Paranda URL, taasta ressurss või kasuta 410-t, kui tead, et eemaldamine on püsiv.

Ressurss on olemas, kuid ei toeta selles päringus kasutatud meetodit.

Tegevusjuhised: Tagasta Allow-päis, kus on loetletud ressursi toetatud meetodid.

Server ei saa luua esitust, mis vastaks kliendi ennetavatele Accept-eelistustele.

Tegevusjuhised: Leevenda Accept-piiranguid või seadista sobiv esitus/läbirääkimispoliitika.

Vahendav proxy nõuab enne päringu edastamist autentimisandmeid.

Tegevusjuhised: Autendi end proxys, kasutades Proxy-Authenticate’i / Proxy-Authorizationi; see erineb lähte serveri autentimisest.

Server ei saanud täielikku päringut aja jooksul, mille jooksul ta oli valmis seda ootama. Klient võib uue ühenduse kaudu uuesti proovida.

Tegevusjuhised: Kontrolli võrgu katkestusi, üleslaadimise mahtu ning serveri/proxy ajalõpu seadeid.

Päring on ressursi praeguse olekuga vastuolus, näiteks versioonikonflikti või duplikaadi loomise katse tõttu.

Tegevusjuhised: Selgita konflikti ja anna kliendile selle lahendamiseks piisavalt teavet praeguse oleku kohta.

Ressurss pole tahtlikult ja tõenäoliselt püsivalt kättesaadav ning teadaolevat asendust pole. See on tugevam vastus kui üldine leidmata-olek.

Tegevusjuhised: Kasuta seda siis, kui eemaldamine on tahtlik; kustuta aegunud siselingid ja viited.

Server nõuab Content-Length-päist, kuid päringus seda ei olnud.

Tegevusjuhised: Saada õige Content-Length või kasuta toetatud edastusraamimist.

Päringu tingimus, näiteks If-Match, osutus vääraks ning server ei teinud soovitud toimingut.

Tegevusjuhised: Värskenda esitust ja proovi uuesti kehtivate kontrollväärtuste/olekuga.

Päringukeha ületab piiri, mida server on valmis või suuteline töötlema. Server võib ühenduse sulgeda või lubada uuesti proovida pärast keha vähendamist.

Tegevusjuhised: Vähenda sisu mahtu või kohanda dokumenteeritud üleslaadimispiiranguid.

Päringu siht on pikem, kui server on valmis tõlgendama, sageli liiga pika päringustringi tõttu.

Tegevusjuhised: Kasuta lühemat URI-t või vii sobivad andmed päringukehasse.

Server keeldub päringukehast, sest meediatüüp, sisu kodeering või kontrollitud vorming pole toetatud.

Tegevusjuhised: Saada toetatud Content-Type ja kodeering ning neile vastav sisu.

Küsitud baidivahemikku ei saa edastada, näiteks kui see algab esituse pikkusest kaugemal.

Tegevusjuhised: Kontrolli ressursi pikkust ja vahemiku ühikuid; serverid võivad tagastada päise Content-Range: bytes */length.

Server või vahendaja ei saa täita Expect-päises deklareeritud ootust.

Tegevusjuhised: Proovi vajaduse korral ja ohutult uuesti ilma toetamata ootuseta.

Humoorikas olekukood, mis pärineb aprillinalja spetsifikatsioonist. See pole tavaline rakenduse tõrkeleping, kuigi mõned teenused kasutavad seda naljatledes.

Tegevusjuhised: Ära sõltu sellest koodist koostalitlusvõimelises tootmiskeskkonnas.

Päring jõudis serverisse, mis ei saa siht-URI jaoks anda autoriteetset vastust; sageli ei ühti ühenduse marsruutimine või HTTP autoriteet.

Tegevusjuhised: Proovi sobiva ühenduse kaudu uuesti ning kontrolli Host/:authority, SNI-d ja proxy marsruutimist.

Sisu tüüp ja süntaks on arusaadavad, kuid server ei saa juhiseid rakendada ega esitatud sisu valideerida.

Tegevusjuhised: Tagasta konkreetne, välja kaupa valideerimise teave; andmesisu parandamine võib päringu edukaks muuta.

WebDAV-i ressurss on lukus, mistõttu ei saa soovitud meetodit kasutada enne lukustuse eemaldamist.

Tegevusjuhised: Kontrolli luku omanikku, ajalõppu ja WebDAV-i lukutokenite käsitlemist.

WebDAV-i toiming ebaõnnestus, sest samas päringujadas ebaõnnestus vajalik eelnev toiming.

Tegevusjuhised: Lahenda eelnev nurjunud toiming enne sellest sõltuvate toimingute kordamist.

Server keeldub töötlemast päringut, mida võidi varajaste andmete ajal uuesti esitada, et vähendada taasesituse riski.

Tegevusjuhised: Proovi uuesti pärast ühenduse loomist ilma varajaste andmeteta.

Server keeldub praegusest protokollist ja teatab, et klient peaks vahetama selle teise vastu.

Tegevusjuhised: Lisa Upgrade-päis, mis kirjeldab toetatud protokollivalikuid.

Server nõuab kaotatud muudatuste vältimiseks tingimuslikku päringut, kuid klient saatis tingimusteta päringu.

Tegevusjuhised: Hangi praegune olek ja saada sobiv tingimus, näiteks If-Match.

Klient on saatnud määratud ajavahemikus liiga palju päringuid serveri kehtestatud päringupiirangu järgi.

Tegevusjuhised: Vähenda päringute sagedust, järgi päist Retry-After, kui see on olemas, ja väldi sünkroonitud korduspäringute hooge.

Server ei töötle päringut, sest üks või mitu päisevälja või päiste kogumaht on liiga suur.

Tegevusjuhised: Vähenda küpsiseid või kohandatud päiseid või kohanda teadlikult seatud serveripiirangut.

Server ei saa taotletud ressurssi õigusliku piirangu tõttu esitada.

Tegevusjuhised: Selgita võimaluse korral piirangut ja selle ulatust kaitstud teavet avaldamata.

Serveris tekkis ootamatu olukord ja ta ei saa päringut lõpule viia. See on üldine varuolek, kui täpsemat serveritõrget pole võimalik kasutada.

Tegevusjuhised: Seo päring serverilogidega ja ära avalda külastajatele pinu jälge.

Server ei toeta päringu täitmiseks vajalikku funktsiooni, tavaliselt rakendamata meetodit või võimalust.

Tegevusjuhised: Rakenda vajalik funktsioon või kasuta toetatud meetodit; see olek pole mõeldud ajutise ülekoormuse jaoks.

Lüüsi või proxyna töötav server sai ülesvoolu serverilt vigase vastuse.

Tegevusjuhised: Kontrolli ülesvoolu teenuse seisundit, protokolli/TLS-i seadeid, DNS-i ja proxy logisid.

Server ei saa ajutiselt päringut käsitleda, sageli hoolduse või ülekoormuse tõttu.

Tegevusjuhised: Lisa võimaluse korral Retry-After, abistav vastus ja ajutise tõrkega sobivad vahemälupäised.

Lüüs või proxy ei saanud ülesvoolu teenuselt õigeaegset vastust.

Tegevusjuhised: Uuri ülesvoolu viivitust, võrguteid ja ajalõppe kogu päringuahela ulatuses.

Server ei toeta päringus kasutatud HTTP põhiversiooni.

Tegevusjuhised: Kasuta toetatud protokolliversiooni või uuenda serveri/proxy konfiguratsiooni.

Serveri konfiguratsiooniviga tekitas ringikujulise sisuläbirääkimise, kus valitud variant alustab läbirääkimist uuesti.

Tegevusjuhised: Paranda variandi/läbirääkimise konfiguratsioon; tegemist on lähte serveri veaga.

WebDAV-server ei saa toimingu lõpetamiseks vajalikku esitust salvestada.

Tegevusjuhised: Vabasta või lisa salvestusruumi ning kontrolli enne uut katset kvoote.

Server tuvastas päringu töötlemisel lõputu tsükli, sageli WebDAV-i seoste läbimisel.

Tegevusjuhised: Katkesta tsükliline ressursiseos või töötlemisreegel.

Päring nõuab laiendit, mida server ei toeta.

Tegevusjuhised: Kasuta toetatud laiendite kogumit või lepi kokku alternatiiv.

Klient peab võrgule juurdepääsuks autentima, tavaliselt kinnise portaali kaudu. See on mõeldud võrguvahendajatele, mitte lähteveebisaidi sisselogimiseks.

Tegevusjuhised: Lõpeta võrgu juurdepääsu autentimine ja korda seejärel algset päringut.

Mõni rakendus kasutab seda silti autentimisseansi aegumisel. See pole universaalselt määratud HTTP olekukood, mistõttu kliendid ei saa eeldada ühtset tähendust.

Tegevusjuhised: Värskenda autentimine vastavalt teenuse lepingule.

Mõne pakkuja vastus, mida on ajalooliselt kasutatud päringute piiramiseks. Tähenduse määrab konkreetne teostus.

Tegevusjuhised: Järgi dokumenteeritud päringupiirangu juhiseid.

Mõni server sulgeb ühenduse tavapärast vastust saatmata, sageli filtreerimismeetmena.

Tegevusjuhised: Kontrolli teenusepakkuja logisid; kliendid võivad selle koodi kuvamise asemel teatada võrguveast.

Microsofti laiend, mida mõned teenused kasutavad, et paluda kliendil lisateabega uuesti proovida.

Tegevusjuhised: Järgi konkreetse API dokumentatsiooni.

Pöördproxy võib selle logida, kui klient katkestab ühenduse enne ülesvoolu vastuse valmimist. Tavaliselt on see logikirje klassifikatsioon, mitte kliendile edastatud vastus.

Tegevusjuhised: Uuri kliendi katkestamisi ja aeglaseid ülesvoolu päringuid.

Mõni majutusplatvorm kasutab seda kvoodi või ribalaiuse piirangu korral. Sellel pole üldist koostalitlusvõimelist HTTP tähendust.

Tegevusjuhised: Kontrolli hosti kvooti ja arveldusseadeid.

CDN või proxy võib seda kasutada, kui saab lähte serverilt ootamatu või tühja vastuse.

Tegevusjuhised: Võrdle serva- ja lähte serveri logisid ning veendu, et lähte server väljastab kehtiva HTTP vastuse.

Proxy ei suutnud lähte serveriga ühendust luua või lähte server keeldus ühendusest.

Tegevusjuhised: Kontrolli lähte serveri kättesaadavust, tulemüüri reegleid ja proxy lubatud loendeid.

Servateenus lõi lähte serveriga ühenduse või proovis seda teha, kuid vahetus ei jõudnud ajalõpu jooksul lõpule.

Tegevusjuhised: Kontrolli lähte serveri reageerimiskiirust ja võrguviivitust.

Proxy ei saanud ühendust seadistatud lähteaadressiga.

Tegevusjuhised: Kontrolli DNS-i lahendamist, marsruutimist ja lähte serveri IP-konfiguratsiooni.

Ühendus lähte serveriga õnnestus, kuid see ei saatnud õigeaegset HTTP vastust.

Tegevusjuhised: Vähenda lähte serveri töötlemisaega või kohanda toetatud ajalõpu seadeid.

Proxy ei suutnud lähte serveriga TLS-i läbirääkimist lõpule viia.

Tegevusjuhised: Kontrolli sertifikaate, protokolli/šifrite ühilduvust ja SNI-d.

Vahendaja lükkas kontrolli käigus lähte serveri sertifikaadi tagasi.

Tegevusjuhised: Paigalda kehtiv, õigesti nimetatud, usaldatud ja aegumata sertifikaat koos täieliku sertifikaadiahelaga.

Pärand- või pakkujapõhine proxy olek näitab tõrget lähte serveri kiirendusühenduses.

Tegevusjuhised: Kontrolli teenusepakkuja ühendusmoodulit ja lähte serveri teed.

Mõni klient või proxy kasutab seda võrgu lugemise ajalõpu kirjeldamiseks. Sellel pole universaalset HTTP tähendust.

Tegevusjuhised: Kontrolli kliendi/proxy diagnostikat.

Mõni proxy kasutab seda võrguühenduse loomise katse ajalõpu korral. Tähendus sõltub konkreetsest teostusest.

Tegevusjuhised: Kontrolli kättesaadavust ja ajalõpu seadeid.