HTTP-vastausten tilakoodit

Palvelin on hyväksynyt pyynnön otsakkeet ja odottaa jäljellä olevaa pyyntörunkoa. Tätä käytetään tavallisesti yhdessä Expect: 100-continue -otsakkeen kanssa, jotta asiakas voi välttää suuren rungon lähettämisen, jos pyyntö hylätään.

Toimintaohje: Välivastaus; jatka rungon lähettämistä vain, jos sitä odotetaan.

Palvelin suostuu vaihtamaan tämän yhteyden protokollaa asiakkaan pyytämän päivityksen jälkeen. WebSocket-kättely on tuttu käyttötapa.

Toimintaohje: Yhteystason siirtymä; tarkista Upgrade- ja Connection-otsakkeet.

WebDAV-palvelin ilmoittaa pitkän toiminnon alkaneen, mutta se ei ole vielä valmis. Vastaus on vanhentunut tai poistettu käytöstä; älä sekoita sitä lopulliseen tulokseen.

Toimintaohje: WebDAV:n välitilakoodi; odota lopullista vastausta.

Palvelin lähettää alustavia otsakkeita, usein Link-vihjeitä, valmistellessaan lopullista vastausta. Asiakas voi aloittaa todennäköisesti tärkeiden resurssien hakemisen ennakkoon.

Toimintaohje: Väliaikainen optimointi; lopullisen vastauksen on seurattava.

Pyyntö onnistui. Palautettava sisältö riippuu metodista: GET palauttaa resurssin, HEAD palauttaa metatiedot ilman runkoa ja kirjoittava toiminto voi palauttaa tulosta kuvaavan esityksen.

Toimintaohje: Käytä valmiille pyynnölle, kun vastausesitys on tilanteeseen sopiva.

Pyyntö valmistui ja loi yhden tai useamman resurssin. Vastauksen tulisi yksilöidä uusi resurssi, tavallisesti Location-otsakkeella, ja se voi palauttaa resurssin esityksen.

Toimintaohje: Tyypillinen POST- tai PUT-pyynnön jälkeen; varmista, että luotu resurssi on löydettävissä.

Palvelin hyväksyi pyynnön käsiteltäväksi, mutta käsittely ei ole valmis ja voi yhä epäonnistua. HTTP ei toimita myöhemmin toista vastausta saman yhteydenoton jatkoksi.

Toimintaohje: Ilmoita toiminnon tai tilan URL-osoite tai muu tapa selvittää lopullinen tulos.

Muunnettu välityspalvelin tai välijärjestelmä palautti lähdevastauksesta poikkeavat metatiedot tai sisällön. Tämä ilmaisee, ettei kyseessä ole suora ja auktoritatiivinen esitys alkuperäisestä vastauksesta.

Toimintaohje: Käytä vain, kun välijärjestelmän tekemällä muunnoksella on merkitystä.

Pyyntö onnistui, eikä lähetettävää vastaussisältöä ole. Otsakkeissa voi silti olla hyödyllisiä metatietoja, kuten päivitettyjä validointitunnisteita.

Toimintaohje: Älä sisällytä vastausrunkoa.

Pyyntö onnistui, ja asiakkaan tulee nollata näkymä tai lomake, josta pyyntö lähetettiin. Vastaussisältöä ei lähetetä.

Toimintaohje: Sopii toimintoihin, joiden jälkeen nykyinen syöttötila tulee tyhjentää tai palauttaa alkutilaan.

Palvelin täytti kelvollisen tavuvälipyynnön ja palauttaa vain pyydetyn tavuvälin tai -välit. Content-Range kertoo, mitä toimitettiin.

Toimintaohje: Varmista Range- ja Content-Range-arvojen vastaavuus; käytetään usein jatkettavissa media- ja lataustoiminnoissa.

WebDAV-vastaus ilmoittaa erilliset tulokset useille resursseille tai alitoiminnoille, yleensä rakenteisessa XML-rungossa.

Toimintaohje: Tulkitse kunkin sisällytetyn resurssin tulos; ulompi tilakoodi ei yksin kerro koko lopputulosta.

WebDAV:n multistatus-vastaus jättää pois aiemmin samassa vastauksessa luetellut jäsenet, jotta niitä ei toisteta.

Toimintaohje: WebDAV-kohtainen; tulkitse yhdessä ympäröivän multistatus-vastauksen kanssa.

Palvelin täytti GET-pyynnön ilmentymämuunnoksilla ja palauttaa nykyisestä resurssista johdetun esityksen neuvotellun delta-mekanismin mukaisesti.

Toimintaohje: Erikoistunut delta-koodaus; asiakkaan ja palvelimen on sovittava muunnoksesta.

Kohteella on useita esityksiä tai määränpäitä, ja vastaus tarjoaa vaihtoehtoja. Asiakas tai käyttäjä voi valita sopivan version.

Toimintaohje: Tarjoa selkeät vaihtoehdot; älä oleta, että jokainen asiakas valitsee automaattisesti.

Resurssilla on pysyvä uusi URI. Asiakkaat voivat päivittää tallennettuja linkkejä ja välimuisteja, joten käytä koodia vain, kun siirron on tarkoitus jäädä voimaan.

Toimintaohje: SEO-siirroissa ohjaa suoraan lopulliseen vastaavaan URL-osoitteeseen ja päivitä sisäiset linkit.

Resurssi sijaitsee tilapäisesti toisessa URI-osoitteessa. Historiallinen toiminta sallii joissakin tilanteissa metodin vaihtumisen, joten tämä ei ole turvallisin valinta, jos POST-pyynnön tulee säilyä POST-pyyntönä.

Toimintaohje: Käytä tilapäiseen siirtoon, kun metodin muuttuminen käy; muussa tapauksessa harkitse 307-koodia.

Asiakkaan tulee hakea Location-otsakkeessa ilmoitettu resurssi GET-metodilla (tai tilanteeseen sopivasti HEAD-metodilla) alkuperäisen toiminnon toistamisen sijaan. Käytetään usein lomakkeen lähetyksen jälkeen.

Toimintaohje: Toteuttaa Post/Redirect/Get-mallin ja estää toiminnon lähettämisen uudelleen.

Ehdollinen GET- tai HEAD-pyyntö osoittaa, että välimuistissa oleva esitys on yhä ajan tasalla. Vastauksessa ei ole runkoa, joten asiakas voi käyttää tallennettua kopiota.

Toimintaohje: Palauta vain, kun esimerkiksi If-None-Match- tai If-Modified-Since-validointiehto täsmää.

Historiallinen vastaus ehdotti, että asiakas käyttäisi resurssin hakemiseen välityspalvelinta. Se on poistettu käytöstä tietoturvasyistä, eikä nykyisten palveluiden tule käyttää sitä.

Toimintaohje: Älä ota käyttöön; määritä välityspalvelimet muilla keinoin.

Tämä arvo on varattu tai käyttämätön nykyaikaisissa HTTP-määrityksissä. Sillä ei ole nykyisissä verkkosovelluksissa standardoitua toiminnallista merkitystä.

Toimintaohje: Älä lähetä tätä koodia.

Resurssi sijaitsee tilapäisesti toisessa URI-osoitteessa, ja asiakkaan tulee säilyttää alkuperäinen metodi ja runko uudelleenohjausta seurattaessa.

Toimintaohje: Käytä, kun tilapäisen siirron yhteydessä POST-metodia ei saa muuttaa GET-metodiksi.

Resurssi on siirretty pysyvästi, ja asiakkaan tulee säilyttää alkuperäinen metodi ja runko uudelleenohjausta seurattaessa.

Toimintaohje: Käytä pysyvään siirtoon, kun metodin säilyttäminen on tärkeää; päivitä canonical- ja sisäiset viittaukset.

Palvelin ei voi käsitellä pyyntöä, koska sen syntaksi, kehystys tai annetut tiedot ovat virheellisiä. Saman pyynnön toistaminen muuttamatta sitä tuskin auttaa.

Toimintaohje: Tarkista URL-koodaus, JSON- tai runkosyntaksi, pakolliset kentät ja pyynnön kehystys.

Pyynnöstä puuttuvat kohteen kelvolliset todennustiedot. Nimestään huolimatta vastaus tarkoittaa, että todennus vaaditaan tai epäonnistui.

Toimintaohje: Lähetä vaaditut tunnistetiedot ja sisällytä WWW-Authenticate-haaste.

Varattu tulevaa käyttöä varten, vaikka jotkin tuotteet käyttävät sitä maksamiseen tai kiintiöiden hallintaan. Yhtä yleisesti yhteentoimivaa maksukäyttäytymistä ei ole määritelty.

Toimintaohje: Käsittele toimittajakohtaiset merkitykset sellaisina ja dokumentoi API-sopimus.

Palvelin ymmärsi pyynnön mutta kieltäytyy täyttämästä sitä. Kelvolliset tunnistetiedot eivät välttämättä muuta tulosta, sillä rajoitus voi perustua käytäntöön.

Toimintaohje: Tarkista käyttöoikeudet, pääsykäytännöt, IP- ja WAF-säännöt sekä resurssikohtainen valtuutus.

Palvelin ei löydä pyydetylle URI-osoitteelle nykyistä esitystä tai ei halua paljastaa sen olemassaoloa. Vastaus ei yksin kerro, onko puuttuminen tilapäistä vai pysyvää.

Toimintaohje: Korjaa URL, palauta resurssi tai käytä 410-koodia, jos poistaminen on varmasti pysyvää.

Resurssi on olemassa, mutta se ei tue tässä pyynnössä käytettyä metodia.

Toimintaohje: Palauta Allow-otsake, jossa luetellaan resurssin hyväksymät metodit.

Palvelin ei voi tuottaa esitystä, joka vastaa asiakkaan ennakoivia Accept-mieltymyksiä.

Toimintaohje: Löysää Accept-rajoituksia tai määritä sopiva esitys- ja neuvottelukäytäntö.

Välittävä välityspalvelin vaatii tunnistetiedot ennen pyynnön välittämistä.

Toimintaohje: Todenna välityspalvelimelle Proxy-Authenticate- ja Proxy-Authorization-otsakkeilla; tämä eroaa alkuperäispalvelimen todennuksesta.

Palvelin ei saanut koko pyyntöä sille varatun ajan kuluessa. Asiakas voi yrittää uudelleen uudella yhteydellä.

Toimintaohje: Tarkista verkkokatkokset, lähetyksen koko sekä palvelimen tai välityspalvelimen aikakatkaisuasetukset.

Pyyntö on ristiriidassa resurssin nykyisen tilan kanssa, esimerkiksi version törmäyksen tai kaksoiskappaleen luontiyrityksen vuoksi.

Toimintaohje: Kuvaa ristiriita ja anna asiakkaalle riittävästi ajantasaista tietoa sen ratkaisemiseksi.

Resurssi ei ole tarkoituksellisesti ja todennäköisesti pysyvästi saatavilla, eikä sille tunneta korvaavaa osoitetta. Tämä on vahvempi ilmoitus kuin yleinen puuttuvan resurssin vastaus.

Toimintaohje: Käytä, kun poisto on tarkoituksellinen; poista vanhentuneet sisäiset linkit ja viittaukset.

Palvelin vaatii Content-Length-otsakkeen, mutta pyyntö ei sisältänyt sitä.

Toimintaohje: Lähetä oikea Content-Length tai käytä tuettua siirtokehystystä.

Pyyntöehto, kuten If-Match, ei täyttynyt, joten palvelin ei suorittanut pyydettyä toimintoa.

Toimintaohje: Päivitä esitys ja yritä uudelleen nykyisillä validointitiedoilla tai tilalla.

Pyynnön runko ylittää rajan, jonka palvelin pystyy tai suostuu käsittelemään. Palvelin voi sulkea yhteyden tai sallia uuden yrityksen pienemmän rungon kanssa.

Toimintaohje: Pienennä hyötykuormaa tai muuta dokumentoituja lähetysrajoja.

Pyynnön kohde on pidempi kuin palvelin suostuu tulkitsemaan. Syynä on usein liian pitkä kyselymerkkijono.

Toimintaohje: Käytä lyhyempää URI-osoitetta tai siirrä sopivat tiedot pyynnön runkoon.

Palvelin hylkää pyynnön rungon, koska sen mediatyyppi, sisältökoodaus tai tarkastettu muoto ei ole tuettu.

Toimintaohje: Lähetä tuettu Content-Type ja koodaus sekä niiden mukainen runko.

Pyydettyä tavualuetta ei voida toimittaa, esimerkiksi jos se alkaa esityksen lopun jälkeen.

Toimintaohje: Tarkista resurssin pituus ja tavuvälien yksiköt; palvelin voi palauttaa Content-Range: bytes */pituus.

Palvelin tai välijärjestelmä ei pysty täyttämään Expect-otsakkeessa ilmoitettua odotusta.

Toimintaohje: Yritä turvallisesti ja tilanteen salliessa uudelleen ilman tukematonta odotusta.

Huumorimielessä April Fools’ -määrityksessä esitelty tilakoodi. Se ei ole tavallinen sovellusvirheen sopimus, vaikka jotkin palvelut käyttävät sitä leikillisesti.

Toimintaohje: Älä nojaa tähän yhteentoimivan tuotantotoiminnan perustana.

Pyyntö saapui palvelimelle, joka ei voi tuottaa kohde-URI-osoitteelle auktoritatiivista vastausta. Syynä on usein yhteyden reitityksen ja HTTP-viranomaisnimen ristiriita.

Toimintaohje: Yritä sopivalla yhteydellä ja tarkista Host/:authority, SNI sekä välityspalvelimen reititys.

Sisällön tyyppi ja syntaksi ymmärretään, mutta palvelin ei voi toteuttaa ohjeita tai vahvistaa lähetettyä sisältöä.

Toimintaohje: Palauta käyttökelpoiset kenttäkohtaiset validointitiedot; hyötykuorman korjaaminen voi mahdollistaa onnistumisen.

WebDAV-resurssi on lukittu, joten pyydettyä metodia ei voi suorittaa ennen lukituksen ratkaisemista.

Toimintaohje: Tarkista lukituksen omistaja, aikakatkaisu ja WebDAV-lukitustunnuksen käsittely.

WebDAV-toiminto epäonnistui, koska saman pyyntösarjan aiempi pakollinen toiminto epäonnistui.

Toimintaohje: Ratkaise aiempi virhe ennen siitä riippuvien toimintojen uutta yritystä.

Palvelin kieltäytyy käsittelemästä pyyntöä, joka on voitu toistaa varhaisen datan aikana. Näin pienennetään toistohyökkäysten riskiä.

Toimintaohje: Yritä uudelleen, kun yhteys on muodostettu ilman varhaista dataa.

Palvelin hylkää nykyisen protokollan ja ilmoittaa, että asiakkaan tulee siirtyä toiseen protokollaan.

Toimintaohje: Ilmoita Upgrade-otsakkeessa tuetut protokollavaihtoehdot.

Palvelin vaatii ehdollisen pyynnön kadonneiden päivitysten estämiseksi, mutta asiakas lähetti ehdottoman pyynnön.

Toimintaohje: Hae nykyinen tila ja lähetä sopiva ehto, esimerkiksi If-Match.

Asiakas lähetti liian monta pyyntöä palvelimen määrittämän ajanjakson aikana.

Toimintaohje: Hidasta pyyntötahtia, noudata Retry-After-otsaketta sen esiintyessä ja vältä samanaikaisia uudelleenyrityspiikkejä.

Palvelin ei käsittele pyyntöä, koska yksi tai useampi otsakekenttä tai otsakkeiden kokonaisuus on liian suuri.

Toimintaohje: Pienennä evästeitä tai omia otsakkeita tai säädä tarkoituksella asetettua palvelinrajaa.

Palvelin ei voi toimittaa pyydettyä resurssia oikeudellisen rajoituksen vuoksi.

Toimintaohje: Selitä soveltuvissa tilanteissa rajoituksen syy ja laajuus paljastamatta suojattuja tietoja.

Palvelimessa ilmeni odottamaton tilanne, eikä se voi suorittaa pyyntöä loppuun. Tämä on yleinen varakoodi, kun tarkempaa palvelinvirhettä ei voida käyttää.

Toimintaohje: Yhdistä pyyntö palvelinlokeihin äläkä näytä kävijöille pinon jäljityksiä.

Palvelin ei tue pyynnön täyttämiseen vaadittua toimintoa, yleensä toteuttamatonta metodia tai ominaisuutta.

Toimintaohje: Toteuta toiminto tai käytä tuettua metodia; tätä ei ole tarkoitettu tilapäisen ylikuormituksen ilmoittamiseen.

Yhdyskäytävänä tai välityspalvelimena toimiva palvelin sai virheellisen vastauksen ylemmältä palvelimelta.

Toimintaohje: Tarkista ylemmän palvelimen tila, protokolla- ja TLS-asetukset, DNS sekä välityspalvelimen lokit.

Palvelin ei tilapäisesti pysty käsittelemään pyyntöä, usein huollon tai ylikuormituksen vuoksi.

Toimintaohje: Ilmoita mahdollisuuksien mukaan Retry-After, hyödyllinen virhevastaus ja tilapäiseen häiriöön sopivat välimuistiohjeet.

Yhdyskäytävä tai välityspalvelin ei saanut oikea-aikaista vastausta ylemmältä palvelulta.

Toimintaohje: Tutki ylemmän palvelun viivettä, verkkoreittejä ja ketjun aikakatkaisurajoja.

Palvelin ei tue pyynnössä käytettyä HTTP:n pääversiota.

Toimintaohje: Käytä tuettua protokollaversiota tai päivitä palvelimen ja välityspalvelimen asetukset.

Palvelimen määritysvirhe aiheutti sisältöneuvottelun kehän, jossa valittu vaihtoehto aloittaa neuvottelun uudelleen.

Toimintaohje: Korjaa vaihtoehdon tai neuvottelun määritys; virhe on alkuperäispalvelimessa.

WebDAV-palvelimella ei ole riittävästi tallennustilaa toiminnon vaatiman esityksen tallentamiseen.

Toimintaohje: Vapauta tai varaa tallennustilaa ja tarkista kiintiöt ennen uutta yritystä.

Palvelin havaitsi pyynnön käsittelyn aikana loputtoman silmukan, tavallisesti WebDAV-sidosten läpikäynnissä.

Toimintaohje: Katkaise resurssien välinen kehä tai korjaa käsittelysääntö.

Pyyntö edellyttää laajennusta, jota palvelin ei tue.

Toimintaohje: Käytä tuettua laajennusjoukkoa tai neuvottele vaihtoehtoinen tapa.

Asiakkaan on todennettava verkkoyhteytensä, tavallisesti kirjautumissivulla. Koodi on tarkoitettu verkkovälittäjille, ei alkuperäisen verkkosivuston kirjautumiseen.

Toimintaohje: Suorita verkkoon kirjautuminen ja yritä sitten alkuperäistä pyyntöä uudelleen.

Jotkin sovellukset käyttävät tätä nimitystä todennusistunnon vanhentuessa. HTTP ei ole määrittänyt sille yleispätevää tilakoodia, joten asiakkaat eivät voi odottaa yhdenmukaista merkitystä.

Toimintaohje: Päivitä todennus palvelun sopimuksen mukaisesti.

Toimittajakohtainen vastaus, jota on historiallisesti käytetty pyyntötahtiin rajoittamiseen. Merkitys määräytyy toteutuksen mukaan.

Toimintaohje: Noudata dokumentoituja pyyntörajavinkkejä.

Jotkin palvelimet sulkevat yhteyden lähettämättä tavanomaista vastausta, usein suodatustoimena.

Toimintaohje: Tarkista palveluntarjoajan lokit; asiakas voi ilmoittaa verkkovirheestä tämän koodin näyttämisen sijaan.

Microsoftin laajennus, jota jotkin palvelut käyttävät pyytäessään asiakasta yrittämään uudelleen lisätietojen kanssa.

Toimintaohje: Noudata kyseisen API:n dokumentaatiota.

Käänteinen välityspalvelin voi kirjata tämän, kun asiakas katkaisee yhteyden ennen ylemmän palvelimen vastauksen valmistumista. Kyseessä on yleensä lokiluokitus, ei asiakkaalle toimitettu vastaus.

Toimintaohje: Tutki asiakkaiden keskeytyksiä ja ylemmän palvelimen hitaita pyyntöjä.

Jotkin hosting-alustat käyttävät tätä koodia kiintiö- tai kaistanleveysrajan ylittyessä. Se ei ole yleisesti yhteentoimiva HTTP-merkitys.

Toimintaohje: Tarkista palveluntarjoajan kiintiöt ja laskutusasetukset.

CDN tai välityspalvelin voi käyttää tätä saadessaan odottamattoman tai tyhjän vastauksen alkuperäispalvelimelta.

Toimintaohje: Vertaa reuna- ja alkuperäpalvelimen lokeja; varmista, että alkuperäpalvelin lähettää kelvollisen HTTP-vastauksen.

Välityspalvelin ei pystynyt muodostamaan yhteyttä alkuperäispalvelimeen tai alkuperäpalvelin hylkäsi yhteyden.

Toimintaohje: Tarkista alkuperäpalvelimen saatavuus, palomuurisäännöt ja välityspalvelimen sallittujen osoitteiden luettelo.

Reunapalvelu muodosti yhteyden alkuperäispalvelimeen tai yritti sitä, mutta yhteydenvaihto ei valmistunut aikakatkaisun puitteissa.

Toimintaohje: Tarkista alkuperäpalvelimen vastausnopeus ja verkkoviive.

Välityspalvelin ei tavoittanut määritettyä alkuperäpalvelimen osoitetta.

Toimintaohje: Tarkista DNS-selvitys, reititys ja alkuperäpalvelimen IP-määritys.

Yhteys alkuperäpalvelimeen onnistui, mutta palvelin ei lähettänyt HTTP-vastausta ajoissa.

Toimintaohje: Lyhennä alkuperäpalvelimen käsittelyaikaa tai muuta tuettuja aikakatkaisuasetuksia.

Välityspalvelin ei pystynyt suorittamaan TLS-neuvottelua alkuperäpalvelimen kanssa.

Toimintaohje: Tarkista varmenteet, protokollien ja salausmenetelmien yhteensopivuus sekä SNI.

Välijärjestelmä hylkäsi alkuperäpalvelimen varmenteen tarkistuksen yhteydessä.

Toimintaohje: Asenna kelvollinen, oikein nimetty, luotettu ja vanhentumaton varmenne sekä täydellinen varmenneketju.

Vanha tai toimittajakohtainen välityspalvelimen tilakoodi ilmoittaa virheestä alkuperäpalvelimen kiihdytysyhteydessä.

Toimintaohje: Tarkista palveluntarjoajakohtainen liitin ja yhteys alkuperäpalvelimeen.

Jotkin asiakkaat tai välityspalvelimet käyttävät tätä verkkolukemisen aikakatkaisusta. Sillä ei ole yleispätevää HTTP-merkitystä.

Toimintaohje: Tutki asiakkaan tai välityspalvelimen diagnostiikkatiedot.

Jotkin välityspalvelimet käyttävät tätä, kun verkkoyhteyden muodostamisyritys aikakatkaistaan. Merkitys riippuu toteutuksesta.

Toimintaohje: Tarkista tavoitettavuus ja aikakatkaisuasetukset.