HTTP-tilakoodiviite
| Koodi | Nimi | Merkitys |
|---|---|---|
| 100 | Jatka | Asiakkaan tulisi jatkaa pyynnön rungolla |
| 101 | Switching Protocols | Protokollan päivitys hyväksytty (esim. WebSocketiin) |
| 200 | OK | Pyyntö onnistui — oletusonnistumisvastaus |
| 201 | Luotu | Uusi resurssi luotiin (tyypillinen POST-onnistuminen) |
| 202 | Hyväksytty | Jonossa asynkronista käsittelyä varten, ei vielä valmis |
| 204 | No Content | Onnistuminen tarkoituksella tyhjällä rungolla |
| 301 | Moved Permanently | Resurssilla on uusi pysyvä URL — päivitä linkit; SEO-arvo siirtyy |
| 302 | Löytyi | Väliaikainen uudelleenohjaus (historiallisesti väärinkäytetty; katso 303/307) |
| 303 | See Other | Uudelleenohjaus GETiin toisessa URL:ssa (post/redirect/get) |
| 304 | Not Modified | Välimuistissa oleva kopio on yhä kelvollinen — varmista uudelleen ETag/Last-Modified-arvoilla |
| 307 | Temporary Redirect | Väliaikainen uudelleenohjaus, joka säilyttää menetelmän ja rungon |
| 308 | Permanent Redirect | Pysyvä uudelleenohjaus, joka säilyttää menetelmän ja rungon |
| 400 | Bad Request | Palvelin ei voi jäsentää/ymmärtää pyyntöä |
| 401 | Unauthorized | Tunnistautuminen vaaditaan tai se epäonnistui (nimestään huolimatta se tarkoittaa tunnistautumatonta) |
| 403 | Kielletty | Tunnistautunut tai ei, pääsy evätään |
| 404 | Not Found | Tässä URL:ssa ei ole resurssia |
| 405 | Method Not Allowed | HTTP-menetelmää ei tueta tälle resurssille |
| 406 | Not Acceptable | Mikään esitysmuoto ei vastaa Accept-otsikoita |
| 408 | Request Timeout | Asiakas kesti liian kauan pyynnön lähettämisessä |
| 409 | Ristiriita | Tilatörmäys, esim. muokkaustörmäys tai kaksoisluonti |
| 410 | Poissa | Pysyvästi poistettu (vahvempi kuin 404 — käytetty tarkoituksella) |
| 411 | Pituus vaaditaan | Content-Length-otsikko vaaditaan |
| 413 | Sisältö liian suuri | Pyynnön runko ylittää palvelimen rajat |
| 414 | URI Too Long | URL ylittää palvelimen rajat |
| 415 | Unsupported Media Type | Pyynnön Content-Typea ei tueta |
| 418 | Olen teekannu | RFC 2324 -vitsikoodi, jota käytetään toisinaan kieltäytymään kahvin keittämisestä |
| 422 | Unprocessable Content | Syntaksi on kunnossa, mutta semantiikka epäonnistuu vahvistuksessa (rajapinnat rakastavat tätä) |
| 425 | Too Early | Palvelin ei halua käsitellä mahdollisesti uudelleentoistettua pyyntöä |
| 429 | Too Many Requests | Nopeusraja saavutettu — peräänny, kunnioita Retry-Afteria |
| 500 | Sisäinen palvelinvirhe | Yleinen palvelinpuolen virhe |
| 501 | Not Implemented | Palvelin ei tue toiminnallisuutta |
| 502 | Bad Gateway | Välityspalvelin/yhdyskäytävä sai virheellisen vastauksen ylävirrasta |
| 503 | Service Unavailable | Ylikuormitettu tai alhaalla huollon vuoksi — usein tilapäistä, voi kantaa Retry-Afteria |
| 504 | Yhdyskäytävän aikakatkaisu | Välityspalvelin/yhdyskäytävä aikakatkaistiin odottaessaan ylävirtaa |
| 505 | HTTP-versiota ei tueta | Pyynnön HTTP-versiota ei tueta |
Tietoa
Tilakoodit ovat palvelimen yhden luvun yhteenveto jokaisesta vastauksesta, luokittain ryhmiteltynä: 1xx tiedottava, 2xx onnistuminen, 3xx uudelleenohjaus, 4xx asiakas virheessä, 5xx palvelin virheessä. Taulukko antaa koodit, jotka työskentelevät kehittäjät todella kohtaavat, käytännössä merkityksellisine vivahteineen — 401 tarkoittaa tunnistautumatonta nimestään huolimatta, 403 on kieltäytyminen kirjautumisesta riippumatta, 422 on rajapinnan vahvistusvirhe, 429 vaatii perääntymistä. Luettelemattomat koodit (1xx:n pitkä häntä ja kokeelliset koodit) ovat niin harvinaisia, että pelkkä luokka kertoo, miten niitä käsitellään.
Usein kysytyt kysymykset
Mikä on ero koodien 401 ja 403 välillä?
401: emme tiedä, kuka olet (tunnistaudu). 403: tiedämme, etkä silti saa.
302 vai 307 väliaikaiseen uudelleenohjaukseen?
307 säilyttää menetelmän ja rungon; 302 antoi asiakasohjelmien historiallisesti vaihtaa POSTin GETiksi. Uudessa työssä kannattaa käyttää koodia 307 (tai 308 pysyvään).