HTTP-tilarivi on termi, joka annetaan HTTP-tilakoodille (todellinen koodinumero), kun siihen liittyy HTTP-perustelu1 (lyhyt kuvaus). Ylläpidämme myös luetteloa HTTP-tilakoodivirheistä (4xx ja 5xx) sekä vinkkejä niiden ratkaisemiseen. Vaikka HTTP-tilarivit ovat teknisesti virheellisiä, niitä kutsutaan usein yksinkertaisesti HTTP-tilakoodeiksi.
HTTP-tilakoodiluokat
Kuten alla näkyy, HTTP-tilakoodit ovat kolminumeroisia kokonaislukuja. Aivan ensimmäistä numeroa käytetään koodin tunnistamiseen tietyssä kategoriassa – yksi näistä viidestä:
- 1XX: Informatiivinen: Pyyntö on hyväksytty tai prosessi jatkuu.
- 2XX: Vahvistaa, että toiminto suoritettiin onnistuneesti tai ymmärrettiin.
- 3XX: Uudelleenohjaus: Jotain muuta on tapahduttava pyynnön suorittamiseksi.
- 4XX: Asiakasvirhe, joka osoittaa, että pyyntöä ei voitu suorittaa loppuun tai sisältää väärän syntaksin.
- 5XX: Palvelinvirhe, joka osoittaa, että palvelin ei pystynyt suorittamaan kelvollista pyyntöä.
HTTP-tilakoodeja ymmärtävien sovellusten ei tarvitse tietää kaikki nämä koodit, mikä tarkoittaa, että tuntemattomalla koodilla on myös tuntematon HTTP-syy, joka ei anna käyttäjälle paljon tietoa. Näiden HTTP-sovellusten on kuitenkin ymmärrettävä luokat tai luokat, kuten kuvailimme ne edellä. Jos ohjelmisto ei tiedä, mitä kyseinen koodi tarkoittaa, se voi ainakin tunnistaa luokan. Esimerkiksi, jos sovellus ei tunne 490-tilakoodia, se voi käsitellä sitä 400-koodina, koska se kuuluu samaan luokkaan, ja olettaa sitten, että asiakaspyynnössä on jotain vialla.
HTTP-tilasäännöt (HTTP-tilakoodit + HTTP-syyt)
| Viralliset HTTP-tilasäännöt | |
|---|---|
| Tilakoodi | Syy Zin |
| 100 | Hyppää kyytiin |
| 101 | Protokollan vaihto |
| 102 | Prosessi |
| 200 | Okei |
| 201 | Luotu |
| 202 | Hyväksytty |
| 203 | Ei-valtuutetut tiedot |
| 204 | Ei sisältöä |
| 205 | Nollaa sisältö |
| 206 | Osan sisältö |
| 207 | Monivaltio |
| 208 | Raportoitu jo |
| 300 | Useita vaihtoehtoja |
| 301 | Siirretty Pysyvästi |
| 302 | Löytänyt sen |
| 303 | Katso Muut |
| 304 | Ei mukautettu |
| 305 | Välityspalvelimen käyttäminen |
| 307 | Väliaikainen poikkeama |
| 308 | Pysyvä poikkeama |
| 400 | huono pyyntö |
| 401 | Luvaton |
| 402 | maksua vaaditaan |
| 403 | Kielletty |
| 404 | Ei löydetty |
| 405 | Menetelmä Ei Sallittu |
| 406 | Ei hyväksyttävä |
| 407 | Välityspalvelimen todennus vaaditaan |
| 408 | Pyynnön aikakatkaisu |
| 409 | Konflikti |
| 410 | Pois |
| 411 | Pituus vaaditaan |
| 412 | Kunto epäonnistui |
| 413 | Liian suuri kokonaisuuspyyntö |
| 414 | Pyynnön URI liian suuri |
| 415 | Mediatyyppiä ei tueta |
| 416 | Pyyntöalue ei tyydytetty |
| 417 | Odotus epäonnistui |
| 421 | Väärin osoitettu pyyntö |
| 422 | Käsittelemätön kokonaisuus |
| 423 | Lukittu |
| 424 | Epäonnistunut riippuvuus |
| 425 | Järjestämätön kokoelma |
| 426 | Päivitys vaaditaan |
| 428 | Pakollinen kunto |
| 429 | Liikaa pyyntöjä |
| 431 | Pyynnön otsikkokentät ovat liian suuret |
| 451 | Ei saatavilla juridisista syistä |
| 500 | Sisäinen palvelinvirhe |
| 501 | Ei toteutettu |
| 502 | Huono portti |
| 503 | Palvelu ei saatavilla |
| 504 | Yhdyskäytävän aikakatkaisu |
| 505 | HTTP-versiota ei tueta |
| 506 | Variant myös neuvottelee |
| 507 | Riittämätön varastotila |
| 508 | Silmukka havaittu |
| 510 | Ei uusittu |
| 511 | Verkkotodennus vaaditaan |
[1] HTTP-tilakoodeihin liittyvät HTTP-syyt ovat vain suositeltavia. Toinen perustelu on sallittu RFC 2616 6.1.1:n mukaan. Saatat nähdä lauseita, joissa HTTP-syyt on korvattu «ystävällisemmällä» kuvauksella tai paikallisella kielellä.
Epäviralliset HTTP-tilasäännöt
Jotkin kolmannen osapuolen palvelut voivat käyttää alla olevia HTTP-tilarivejä virhevastauksina, mutta mikään RFC ei määritä niitä.
| Muut mahdolliset HTTP-tilasäännöt | |
|---|---|
| Tilakoodi | Syy Zin |
| 103 | Tarkistuspiste |
| 420 | Menetelmävirhe |
| 420 | Paranna lepoa |
| 440 | Kirjautumisen aikakatkaisu |
| 449 | Yritä uudelleen kanssa |
| 450 | Windowsin käytönvalvonta estää |
| 451 | Uudelleenohjaus |
| 498 | Virheellinen Token |
| 499 | Tunnus vaaditaan |
| 499 | Virustorjunta on kieltänyt pyynnön |
| 509 | Kaistankäyttörajoitus ylitetty |
| 530 | Sivusto on jäätynyt |
On tärkeää muistaa, että vaikka HTTP-tilakoodit voivat jakaa samat numerot muissa yhteyksissä löydettyjen virhesanomien kanssa, kuten Laitehallinnan virhekoodien kanssa, tämä ei tarkoita, että ne liittyvät millään tavalla.