Skip to content

HTTP-tilakoodit selitettynä

Jokainen yleinen HTTP-vastauksen tilakoodi ryhmiteltynä luokan mukaan: mitä se tarkoittaa ja milloin sen näet. HTTP-tilakoodit-työkalun pikaviitetyökalu.

HTTP-tilakoodit noudattavat yhtä kaavaa: ensimmäinen numero kertoo luokan, loput ovat yksityiskohtia. 1xx tarkoittaa informatiivista, 2xx onnistumista, 3xx uudelleenohjausta, 4xx asiakkaan virhettä ja 5xx palvelimen virhettä. Lue ensimmäinen numero ensin. Kumppanityökalu antaa tutkia yksittäistä koodia syvällisesti.

Viitetaulukko · 55 merkintääAvaa työkalu http-status-codes →
55 of 55 rows
1xx Informatiiviset
ContinuePalvelin vastaanotti pyynnön otsakkeet ja asiakas saa lähettää rungon.Esitarkistus ennen suuren rungon latausta.
Switching ProtocolsPalvelin suostuu vaihtamaan asiakkaan pyytämään protokollaan.HTTP-yhteyden päivittäminen WebSocketiksi.
ProcessingPalvelin on vastaanottanut pyynnön ja työstää sitä yhä.WebDAV-palvelin kuittaa pitkän pyynnön, jotta asiakas ei aikakatkaise.
Early HintsPalvelin lähettää alustavat otsakkeet ennen kuin lopullinen vastaus on valmis.Selain saa esiladata resursseja, kun sivua vielä renderöidään.
2xx Onnistuminen
OKPyyntö onnistui ja vastauksen runko sisältää tuloksen.Vakioonnistuminen GET- tai PUT-pyynnölle.
CreatedPyyntö onnistui ja uusi resurssi luotiin.Palautetaan onnistuneen POST-pyynnön jälkeen, joka luo jotakin.
AcceptedPyyntö hyväksyttiin käsittelyyn, mutta se ei ole vielä valmis.Pitkäkestoinen työ on käynnistynyt ja suoritetaan asynkronisesti.
Non-Authoritative InformationPyyntö onnistui, mutta palautettua dataa muunnettiin paluumatkalla.Välityspalvelin tai välimuisti tarjoaa muunnettua metadataa alkuperän sijaan.
No ContentPyyntö onnistui eikä palautettavaa runkoa ole.DELETE onnistui, tai PUT ilman sanottavaa.
Reset ContentPyyntö onnistui ja asiakkaan pitäisi nollata sen lähettämä näkymä.Lomakkeen lähetyksen jälkeen käsketään sivua tyhjentämään kenttänsä.
Partial ContentPalvelin palauttaa vain pyydetyn osan resurssista.Tavualueen palvelu Range-pyynnöstä.
3xx Uudelleenohjaus
Moved PermanentlyResurssilla on uusi pysyvä URL ja tulevien pyyntöjen pitäisi käyttää sitä.Sivu siirtyi ja hakukoneiden pitää päivittää indeksinsä.
FoundResurssi on väliaikaisesti eri URL:ssa, mutta käytä edelleen alkuperäistä.Välittäminen hetkeksi kirjautumissivulle.
See OtherVastaus sijaitsee eri URL:ssa ja se on noudettava GET-pyynnöllä.PRG-malli: POST ohjataan tulossivulle, jotta sivun päivitys ei lähettäisi lomaketta uudelleen.
Not ModifiedVälimuistikopio on yhä kelvollinen, joten palvelin ei lähetä runkoa.Ehdollinen GET, jossa asiakkaan välimuisti on ajan tasalla.
Use ProxyPyyntö on lähetettävä vastauksessa mainitun välityspalvelimen kautta.Vanhat välityspalvelinverkot; vanhennettu vuodesta 2011.
Temporary RedirectResurssi on väliaikaisesti muualla ja alkuperäistä pyyntömetodia on säilytettävä.Kuten 302, mutta POST pysyy POSTina uudelleenohjauksessa.
Permanent RedirectResurssilla on pysyvä uusi URL ja alkuperäistä pyyntömetodia on säilytettävä.Kuten 301, mutta POST pysyy POSTina uudelleenohjauksessa.
4xx Asiakasvirhe
Bad RequestPalvelin ei ymmärtänyt pyyntöä virheellisen syntaksin vuoksi.Viallinen JSON tai puuttuva pakollinen kenttä.
UnauthorizedTunnistautuminen vaaditaan, ja se puuttui tai epäonnistui.Ei tokenia, tai virheellinen tai vanhentunut token.
Payment RequiredPyyntö vaatii maksun, vaikka spesifikaatio ei koskaan määritellyt miten.Eräät API:t käyttävät sitä maksumuurin merkkinä; useimmat eivät koskaan.
ForbiddenAsiakas on tunnistautunut, mutta ei saa käyttää tätä resurssia.Kelvollinen kirjautuminen, mutta ei oikeutta tähän resurssiin.
Not FoundPalvelimella ei ole resurssia tässä URL:ssa.Tuntematon URL tai olematon tunniste.
Method Not AllowedURL on olemassa, mutta se ei salli käytettyä pyyntömetodia.POST endpointiin, joka hyväksyy vain GET-pyynnöt.
Not AcceptablePalvelin ei voi palauttaa sisältöä, joka vastaisi asiakkaan Accept-otsakkeita.Asiakas pyysi vain XML:ää, mutta API palauttaa vain JSONia.
Proxy Authentication RequiredAsiakkaan on tunnistauduttava välityspalvelimelle ennen kuin pyyntö etenee.Yrityksen välityspalvelin hylkää tunnistautumattoman pyynnön.
Request TimeoutAsiakas käytti liikaa aikaa pyynnön lähettämiseen ja palvelin luovutti.Lataus, joka jäi jumiin ennen kuin runko ehti saapua kokonaan.
ConflictPyyntö on ristiriidassa resurssin nykyisen tilan kanssa.Kahdenkertainen sähköpostiosoite tai muokkauskilpailu samasta tietueesta.
GoneResurssi oli aiemmin olemassa, mutta se on poistettu pysyvästi.Tarkoituksella lakkautettu endpoint, vahvempi kuin 404.
Length RequiredPyyntö tarvitsee Content-Length-otsakkeen eikä sillä ole sellaista.Koon etukäteen tunteva palvelin hylkää suoratoistetun rungon.
Precondition FailedOtsakkeen esiehtoon, kuten If-Match, kohdistui epätosi arvo.Optimistinen muokkaus, jossa tietue ehti muuttua asiakkaan lukemisen jälkeen.
Content Too LargePyynnön runko ylittää palvelimen hyväksymän rajan.Lataus, joka on suurempi kuin palvelimen rungon enimmäiskoko.
URI Too LongPyynnön URL on pidempi kuin palvelin suostuu tulkitsemaan.Lomake, joka päätyi vahingossa rajattomasti kasvaneeksi GET-kyselymerkkijonoksi.
Unsupported Media TypePyynnön rungon muoto ei ole endpointin hyväksymä.POST, jossa Content-Type text/plain, JSON-only-endpointiin.
Range Not SatisfiableRange-otsakkeen tavualue ei sovi resurssiin.Tiedoston lopun ylittävien tavujen pyyntä ladattaessa jatkuu.
Expectation FailedPalvelin ei voi täyttää Expect-otsakkeessa esitettyä odotusta.100-continue-odotus, jota palvelin kieltäytyy täyttämästä.
I'm a teapotPalvelin on teekannu ja kieltäytyy keittämästä kahvia.Vuoden 1998 aprillipäivän vitsi, joka ei kuole; API:t palauttavat sitä huvikseen.
Misdirected RequestPyyntö lähetettiin palvelimelle, joka ei voi tuottaa sille vastausta.Uudelleenkäytetty yhteys ohjattiin isäntään, jota tämä palvelin ei palvele.
Unprocessable EntityPyyntö on hyvin muodostettu, mutta sen arvot epäonnistuvat semanttisessa validoinnissa.Kelvollinen JSON, jonka kentät rikkovat liiketoimintasääntöjä.
Too EarlyPalvelin hylkää pyynnön, joka voi olla toistohyökkäys.Toistetun ei-idempotentin pyynnön hylkääminen ennen avainten kierrätystä.
Upgrade RequiredAsiakkaan on vaihdettava toiseen protokollaan käyttääkseen tätä resurssia.Endpoint, joka vaatii TLS:n tai WebSocketin.
Precondition RequiredPalvelin vaatii ehdollisia otsakkeita, joita pyyntö ei lähettänyt.API, joka vaatii If-Match-otsakkeen estämään kadonneet päivitykset.
Too Many RequestsAsiakas on lähettänyt liikaa pyyntöjä annetulla aikaikkunalla.Nopeusraja tuli vastaan; hidasta ja yritä uudelleen.
Request Header Fields Too LargeYksi tai useampi otsakekenttä on liian suuri palvelimen käsiteltäväksi.Eväste tai token, joka kasvoi estämään jokaisen sivuston pyynnön.
Unavailable For Legal ReasonsResurssi on estetty oikeudellisista syistä, kuten poistopyynnöstä tai maantieteellisestä rajoituksesta.Viranomaisen poistopyyntö tai yhdessä maassa estetty sivu.
5xx Palvelinvirhe
Internal Server ErrorPalvelin kohtasi odottamattoman tilan ja epäonnistui.Käsittelemätön poikkeus tai bugi palvelimella.
Not ImplementedPalvelin ei tue pyydettyä metodia tai ominaisuutta.Endpoint on julistettu mutta ei vielä rakennettu.
Bad GatewayYhdyskäytävä tai välityspalvelin sai virheellisen vastauksen ylävirran palvelimelta.Käänteinen välityspalvelin ei tavoittanut backendiä.
Service UnavailablePalvelin ei väliaikaisesti pysty käsittelemään pyyntöä.Ylläpito, ylikuormitus tai alhaalla oleva riippuva palvelu.
Gateway TimeoutYhdyskäytävä tai välityspalvelin ei saanut vastausta ajoissa ylävirran palvelimelta.Backend kesti liian kauan ja välityspalvelin luovutti.
HTTP Version Not SupportedPalvelin ei tue pyynnön HTTP-versiota.Asiakas puhuu protokollaversiota, jota palvelin ei koskaan oppinut.
Variant Also NegotiatesLäpinäkyvä sisältöneuvottelu päättyi kehäviittaukseen.Väärin konfiguroitu palvelin, joka tekee kokeellista sisältöneuvottelua.
Insufficient StoragePalvelin ei voi tallentaa esitystä, jota pyynnön viimeistelemiseen tarvitaan.WebDAV-palvelin, jonka varattu tallennustila on täynnä.
Loop DetectedPalvelin ajautui loputtomaan silmukkaan käsitellessään pyyntöä.WebDAV-sidos, joka viittaa itseensä.
Network Authentication RequiredAsiakkaan on tunnistauduttava verkkoon saadakseen pääsyn.Hotellin tai lentokentän sieppaava portaali, joka ottaa pyynnön kiinni.