Luettelo HTTP-tilakoodeista

Wikipediasta
Siirry navigaatioon Siirry hakuun

Tämä artikkeli on luettelo HTTP-tilakoodeista. HTTP:n tilakoodit (engl. status code) ovat useimmiten kolminumeroisia lukuja, joita käytetään HTTP-pyynnön tilan seurantaan. Numerokoodeja vastaa myös englanninkielinen selitys.

Suurin osa HTTP:n tilakoodeista on RFC 7231:n (Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content) määrittelemiä.[1]

Tilakoodit[muokkaa | muokkaa wikitekstiä]

Tilakoodit jakautuvat viiteen eri sarjaan ensimmäisen numeronsa perusteella:

  • 1xx Informal: Pyyntö on vastaanotettu, jatketaan
  • 2xx Successful: Pyyntö on vastaanotettu, ymmärretty ja käsitelty
  • 3xx Redirection: Jatkotoimenpiteitä tarvitaan pyynnön suorittamiseksi
  • 4xx Client Error: Pyyntöä ei suoritettun onnistuneesti asiakkaasta johtuvan virheen vuoksi
  • 5xx Server Error: Pyyntöä ei suoritettun onnistuneesti palvelimesta johtuvan virheen vuoksi

1xx Informal[muokkaa | muokkaa wikitekstiä]

1xx-sarjan tilakoodit ilmaisevat, että pyyntö on vastaanotettu, mutta sitä ei ole vielä käsitelty. Koska nämä tilakoodit määriteltiin vasta HTTP-standardin versiossa 1.1, niitä ei tulisi[huom 1] lähettää versiota 1.0 käyttäville asiakkaille.

100 Continue
Jatka (engl. continue) -tilakoodi ilmaisee, että asiakasohjelma voi jatkaa pyynnön tekemistä. Tätä koodia voidaan käyttää esimerkiksi siihen, että varmistetaan, onko palvelin valmis ottamaan vastaan suuren POST-pyynnön.[1]
101 Switching Protocols
Vaihdetaan protokollaa (engl. Switching Protocols) -tilakoodi ilmaisee, että palvelin on halukas vaihtamaan protokollaa Upgrade-otsikon mukaisesti.[1][2]
102 Processing (WebDAV, RFC 2518)
WebDAV-laahennuksen lisäämä Käsitellään (engl. Processing) -tilakoodi ilmaisee, että palvelin on vastaanottanut ja käsittelee pyyntöä, mutta siihen ei ole vielä vastausta. Tätä vastausta käytetään aikakatkaisun välttämiseksi.[3]
103 Early Hints (RFC 8297)
Aikaisia vihjeitä (engl. Early Hints) -tilakoodia voidaan käyttää joidenkin otsikoiden (kuten esilatauksessa käytettävän Link-otsikon) palauttamiseen ennen varsinaista sisältöä.[4]

4xx Client Error[muokkaa | muokkaa wikitekstiä]

4xx-sarjan tilakoodit ilmaisevat asiakkaan puolella tapahtuneen virheen.

400 Bad Request
Asiakas on antanut palvelimelle huononmuotoisen pyynnön.
401 Unauthorized
Asiakas ei todistanut henkilöllisyyttään, eikä siis vielä saa resurssia.
403 Forbidden
Asiakkaalla ei ole lukuoikeuksia resurssiin.
404 Not Found
Asiakkaan pyytämää resurssia ei löytynyt.

Huomiot[muokkaa | muokkaa wikitekstiä]

  1. tulkittava kuin must not RFC 2119:n mukaisesti

Lähteet[muokkaa | muokkaa wikitekstiä]

  1. a b c Hypertext Transfer Protocol (HTTP/1.1): Semantics and Content tools.ietf.org. Viitattu 22.7.2019. (englanniksi)
  2. Hypertext Transfer Protocol (HTTP/1.1): Message Syntax and Routing tools.ietf.org. Viitattu 22.7.2019. (englanniksi)
  3. HTTP Extensions for Distributed Authoring -- WEBDAV tools.ietf.org. Viitattu 22.7.2019. (englanniksi)
  4. An HTTP Status Code for Indicating Hints tools.ietf.org. Viitattu 22.7.2019. (englanniksi)
Tämä tekniikkaan liittyvä artikkeli on tynkä. Voit auttaa Wikipediaa laajentamalla artikkelia.