2xx · Onnistuneet
200
OK
Pyyntö onnistui. Sisältö riippuu metodista: GET-pyynnössä resurssi, POST-pyynnössä toiminnon tulos.
Milloin käytetään: Oletusvastaus pyyntöön, joka toimi. Kun jotain uutta luotiin, 201 kertoo enemmän.
Määritelty RFC 9110 §15.3.1
201
Created
Pyyntö onnistui ja loi yhden tai useamman uuden resurssin.
Milloin käytetään: Vastaus POST- tai PUT-pyyntöön, joka loi jotain, ja Location-otsake osoittaa uuteen resurssiin.
Määritelty RFC 9110 §15.3.2
202
Accepted
Pyyntö on hyväksytty käsiteltäväksi, mutta käsittely ei ole valmis ja voi vielä epäonnistua.
Milloin käytetään: Taustalla tehtävälle työlle — jonoon pantu tehtävä, erätuonti — mieluiten linkin kera, josta asiakas voi seurata etenemistä.
Määritelty RFC 9110 §15.3.3
203
Non-Authoritative Information
Pyyntö onnistui, mutta välissä oleva välityspalvelin on muuttanut alkuperäispalvelimelta saamaansa vastausta.
Milloin käytetään: Muuntavat välityspalvelimet lähettävät sen kertoakseen, ettei sisältö ole täsmälleen sitä, mitä alkuperäispalvelin lähetti. Harvinainen.
Määritelty RFC 9110 §15.3.4
204
No Content
Pyyntö onnistui, ja vastauksessa ei tarkoituksella ole sisältöä.
Milloin käytetään: Yleinen vastaus DELETE-pyyntöön tai PUT-pyyntöön, jonka jälkeen asiakas ei tarvitse kopiota takaisin.
Määritelty RFC 9110 §15.3.5
205
Reset Content
Pyyntö onnistui, ja asiakkaan pitää palauttaa pyynnön lähettänyt näkymä alkutilaan, esimerkiksi tyhjentää lomake.
Milloin käytetään: Tarkoitettu tiedonsyöttönäkymille, jotka haluavat lomakkeen tyhjäksi seuraavaa merkintää varten. Selaimet tekevät sillä käytännössä vähän.
Määritelty RFC 9110 §15.3.6
206
Partial Content
Palvelin lähettää vain sen osan resurssista, jota asiakas pyysi Range-otsakkeessa.
Milloin käytetään: Näin videon kelaus, keskeytyneen latauksen jatkaminen ja latausohjelmat hakevat tiedoston paloina.
Määritelty RFC 9110 §15.3.7
207
Multi-Status
WebDAV-vastaus, jonka XML-sisältö kertoo erillisen tilan kullekin useasta resurssista.
Milloin käytetään: Yhdelle pyynnölle, joka koski monia kohteita ja jossa osa saattoi onnistua ja osa epäonnistua.
Määritelty RFC 4918
208
Already Reported
Käytetään WebDAVin 207-vastauksen sisällä kertomaan, että resurssin jäsenet on jo lueteltu aiemmin samassa vastauksessa.
Milloin käytetään: Estää saman kohteen toistumisen, kun kokoelmaan pääsee useamman kuin yhden sidoksen kautta.
Määritelty RFC 5842
226
IM Used
Palvelin on täyttänyt GET-pyynnön, ja vastaus on nykyiseen resurssiin sovellettujen instanssimanipulaatioiden, kuten deltan, tulos.
Milloin käytetään: Osa HTTP:n delta-koodausta (RFC 3229), jossa asiakas pyytää vain sen, mikä on muuttunut sen omasta kopiosta. Harvoin toteutettu.
Määritelty RFC 3229
3xx · Uudelleenohjaus
300
Multiple Choices
Resurssilla on useita esitysmuotoja, ja asiakkaan tai käyttäjän pitää valita yksi.
Milloin käytetään: Harvoin käytetty, koska automaattiseen valintaan ei ole vakiotapaa; palvelimet yleensä valitsevat yhden ja lähettävät sen.
Määritelty RFC 9110 §15.4.1
301
Moved Permanently
Resurssilla on uusi pysyvä osoite, joka annetaan Location-otsakkeessa, ja linkit pitää päivittää siihen.
Milloin käytetään: Sivulle, joka on siirtynyt lopullisesti. Hakukoneet siirtävät sen sijoituksen uuteen osoitteeseen. Asiakas saa muuttaa POSTin GETiksi sitä seuratessaan, joten käytä 308:aa, kun metodilla on väliä.
Määritelty RFC 9110 §15.4.2
302
Found
Tunnetaan myös nimellä: Moved Temporarily
Resurssi on tilapäisesti toisessa osoitteessa, joka annetaan Location-otsakkeessa; alkuperäinen osoite on yhä se, jota kuuluu käyttää.
Milloin käytetään: Lyhytaikaiseen siirtoon, kuten kävijöiden ohjaamiseen kirjautumissivulle. Asiakkaat saavat vaihtaa POSTin GETiksi sitä seuratessaan; 307 kieltää sen.
Määritelty RFC 9110 §15.4.3
303
See Other
Vastaus on toisessa osoitteessa, ja asiakkaan pitää hakea se GET-pyynnöllä.
Milloin käytetään: Klassinen vastaus lomakkeen POST-lähetyksen jälkeen (Post/Redirect/Get), jotta tulossivun uudelleenlataus ei lähetä lomaketta uudestaan.
Määritelty RFC 9110 §15.4.4
304
Not Modified
Asiakkaan välimuistissa oleva kopio on yhä ajan tasalla, joten palvelin ei lähetä sisältöä.
Milloin käytetään: Vastaus ehdolliseen GET-pyyntöön, jossa on If-None-Match tai If-Modified-Since, kun mikään ei ole muuttunut. Ei virhe: välimuisti toimii.
Määritelty RFC 9110 §15.4.5
305
Use Proxy
Ei käytössäKäski aikoinaan asiakasta toistamaan pyynnön Location-otsakkeessa nimetyn välityspalvelimen kautta.
Milloin käytetään: Poistettu käytöstä tietoturvasyistä, koska sen avulla vastaus saattoi ohjata liikenteen haluamansa välityspalvelimen kautta. Älä lähetä sitä.
Määritelty RFC 9110 §15.4.6
306
(Unused)
Ei käytössäVarattu. Aiempi luonnos määritteli sen nimellä Switch Proxy, eikä sitä koskaan käytetty.
Milloin käytetään: Älä koskaan lähetä sitä. Numero pysyy varattuna, jotta sitä ei käytetä uudelleen.
Määritelty RFC 9110 §15.4.7
307
Temporary Redirect
Resurssi on tilapäisesti Location-otsakkeen osoitteessa, ja asiakkaan on toistettava pyyntö siellä samalla metodilla ja sisällöllä.
Milloin käytetään: Tilapäinen uudelleenohjaus silloin, kun POSTin on pysyttävä POSTina. HSTS-siirtymät http:stä https:ään näkyvät selaimissa myös 307:nä.
Määritelty RFC 9110 §15.4.8
308
Permanent Redirect
Resurssi on siirtynyt pysyvästi Location-otsakkeen osoitteeseen, ja asiakkaan on säilytettävä sama metodi ja sisältö.
Milloin käytetään: Pysyvä uudelleenohjaus API:lle tai mille tahansa POST- tai PUT-pyyntöjä ottavalle päätepisteelle, jossa 301 voisi muuttaa pyynnön GETiksi.
Määritelty RFC 9110 §15.4.9
4xx · Asiakkaan virhe
400
Bad Request
Palvelin ei voi käsitellä pyyntöä jonkin sellaisen vuoksi, minkä se katsoo asiakkaan virheeksi, kuten virheellisen syntaksin.
Milloin käytetään: Pyynnölle, jota ei voi jäsentää lainkaan: rikkinäinen JSON, virheellinen otsake, puuttuva pakollinen parametri.
Määritelty RFC 9110 §15.5.1
401
Unauthorized
Pyynnöstä puuttuvat resurssiin kelpaavat tunnistetiedot. Nimestään huolimatta kyse on todennuksesta, ei käyttöoikeuksista.
Milloin käytetään: Kun asiakas ei ole kirjautunut tai sen tunniste on vanhentunut. Vastauksessa on oltava WWW-Authenticate-otsake, joka kertoo, miten todennus tehdään.
Määritelty RFC 9110 §15.5.2
402
Payment Required
Varattu tulevaa käyttöä varten. Määrittely ei ole koskaan kertonut, mitä sen pitäisi tehdä.
Milloin käytetään: Jotkin API:t lähettävät sen, kun tilaus on päättynyt tai maksu epäonnistui, mutta sen takana ei ole vakiintunutta toimintaa.
Määritelty RFC 9110 §15.5.3
403
Forbidden
Palvelin ymmärsi pyynnön ja kieltäytyy täyttämästä sitä. Samojen tunnistetietojen lähettäminen uudelleen ei muuta vastausta.
Milloin käytetään: Kun käyttäjä tunnetaan mutta hänellä ei ole lupaa: jonkun toisen tili, ylläpitosivu, estetty maa tai IP-osoite.
Määritelty RFC 9110 §15.5.4
404
Not Found
Palvelimella ei ole tässä osoitteessa mitään, tai se ei halua kertoa, onko.
Milloin käytetään: Vastaus rikkinäiseen linkkiin tai väärin kirjoitettuun URL-osoitteeseen. Käytetään myös 403:n sijaan, jotta yksityisen resurssin olemassaolo ei paljastu. Jos se on poistettu lopullisesti, 410 kertoo sen.
Määritelty RFC 9110 §15.5.5
405
Method Not Allowed
Palvelin tuntee metodin, mutta tämä resurssi ei tue sitä.
Milloin käytetään: POST-pyynnölle vain luku -osoitteeseen tai DELETE-pyynnölle, kun mitään ei voi poistaa. Vastauksessa on lueteltava sallitut metodit Allow-otsakkeessa.
Määritelty RFC 9110 §15.5.6
406
Not Acceptable
Palvelin ei pysty tuottamaan vastausta yhdessäkään muodossa, jonka asiakas Accept-otsakkeissaan sanoi hyväksyvänsä.
Milloin käytetään: Sisältöneuvottelu, joka ei löytänyt yhteistä muotoa, esimerkiksi vain XML:ää hyväksyvä asiakas ja vain JSONia puhuva API. Useimmat palvelimet lähettävät tällöin oletusmuotonsa.
Määritelty RFC 9110 §15.5.7
407
Proxy Authentication Required
Kuten 401, mutta todennusta asiakkaalta vaatii asiakkaan ja palvelimen välissä oleva välityspalvelin.
Milloin käytetään: Yritysten ja muiden todennusta vaativien välityspalvelimien lähettämä, Proxy-Authenticate-otsakkeen kera, joka kertoo miten.
Määritelty RFC 9110 §15.5.8
408
Request Timeout
Palvelin lakkasi odottamasta, että asiakas saa pyyntönsä lähetettyä loppuun.
Milloin käytetään: Lähetetään käyttämättömälle yhteydelle ennen kuin palvelin sulkee sen. Asiakas voi yksinkertaisesti toistaa pyynnön uudella yhteydellä.
Määritelty RFC 9110 §15.5.9
409
Conflict
Pyyntö on ristiriidassa resurssin nykyisen tilan kanssa.
Milloin käytetään: Muokkaus, joka perustuu vanhentuneeseen versioon, jo varattu käyttäjänimi tai tiedoston lähetys nimellä, joka on jo käytössä.
Määritelty RFC 9110 §15.5.10
410
Gone
Resurssi oli täällä ja on poistettu tarkoituksella, eikä uutta osoitetta ole.
Milloin käytetään: Lopullisesti poistetulle sisällölle. Kertoo hakukoneille 404:ää painokkaammin, ettei sivu palaa.
Määritelty RFC 9110 §15.5.11
411
Length Required
Palvelin hylkää pyynnön, jossa on sisältöä mutta ei Content-Length-otsaketta.
Milloin käytetään: Lähetetään palvelimilta, jotka eivät hyväksy pituudeltaan tuntemattomia paloittaisia (chunked) lähetyksiä.
Määritelty RFC 9110 §15.5.12
412
Precondition Failed
Pyynnön otsakkeissa ollut ehto, kuten If-Match tai If-Unmodified-Since, ei täyttynyt.
Milloin käytetään: Suojaa kadonneilta päivityksiltä: resurssi on muuttunut sen jälkeen, kun asiakas viimeksi luki sen, joten kirjoitus hylätään.
Määritelty RFC 9110 §15.5.13
413
Content Too Large
Tunnetaan myös nimellä: Payload Too Large, Request Entity Too Large
Pyynnön sisältö on suurempi kuin palvelin haluaa tai pystyy käsittelemään. RFC 9110 vaihtoi nimen Payload Too Largesta.
Milloin käytetään: Kokorajan ylittävä lähetys. Jos raja on tilapäinen, Retry-After-otsake kertoo, milloin yrittää uudelleen.
Määritelty RFC 9110 §15.5.14
414
URI Too Long
Tunnetaan myös nimellä: Request-URI Too Long
Pyynnön URI on pidempi kuin palvelin suostuu lukemaan.
Milloin käytetään: Yleensä GET-pyyntönä lähetetty lomake, jossa on valtava kyselymerkkijono, tai uudelleenohjaussilmukka, joka lisäsi osoitteeseen jatkuvasti. Lähetä tiedot POST-sisältönä.
Määritelty RFC 9110 §15.5.15
415
Unsupported Media Type
Palvelin hylkää pyynnön, koska sisältö on muodossa, jota se ei tue.
Milloin käytetään: Väärä tai puuttuva Content-Type, esimerkiksi lomaketiedot päätepisteeseen, joka ottaa vastaan vain application/json-muotoa.
Määritelty RFC 9110 §15.5.16
416
Range Not Satisfiable
Tunnetaan myös nimellä: Requested Range Not Satisfiable
Mikään pyynnön Range-otsakkeen alueista ei osu resurssiin.
Milloin käytetään: Tavujen pyytäminen tiedoston lopun jälkeen, usein kun jatketaan latausta tiedostosta, joka on sittemmin pienentynyt.
Määritelty RFC 9110 §15.5.17
417
Expectation Failed
Palvelin ei pysty täyttämään pyynnön Expect-otsakkeen vaatimusta.
Milloin käytetään: Näkyy lähinnä, kun välityspalvelin tai palvelin ei tue Expect: 100-continue -otsaketta. Uusi yritys ilman otsaketta yleensä toimii.
Määritelty RFC 9110 §15.5.18
418
(Unused)
Ei käytössäTunnetaan myös nimellä: I'm a teapot
Aprillipilakoodi RFC 2324:stä: teekannu, joka kieltäytyy keittämästä kahvia. RFC 9110 varaa numeron, jotta sille ei koskaan anneta oikeaa merkitystä.
Milloin käytetään: Ei tuotantokäyttöön. Jotkin sivustot lähettävät sen pääsiäismunana tai bottien torjumiseksi, mutta asiakkaiden ei voi odottaa ymmärtävän sitä.
Määritelty RFC 9110 §15.5.19
421
Misdirected Request
Pyyntö päätyi palvelimelle, joka ei pysty tuottamaan vastausta pyynnön nimeämälle isännälle.
Milloin käytetään: Tapahtuu lähinnä HTTP/2-yhteyksien uudelleenkäytössä, kun yksi yhteys jaetaan isäntänimille, joita varten palvelinta ei ole määritetty. Asiakkaan pitää yrittää uudelleen uudella yhteydellä.
Määritelty RFC 9110 §15.5.20
422
Unprocessable Content
Tunnetaan myös nimellä: Unprocessable Entity
Palvelin ymmärtää sisältötyypin ja syntaksi on oikein, mutta se ei voi käsitellä pyynnön sisältöä. Aiemmin Unprocessable Entity.
Milloin käytetään: Tavallinen vastaus validointivirheeseen muodoltaan oikeassa pyynnössä. RFC 9110:stä lähtien osa itse HTTP:tä, ei vain WebDAVia.
Määritelty RFC 9110 §15.5.21
423
Locked
WebDAV-resurssi, jota yritetään käyttää, on lukittu.
Milloin käytetään: Tiedosto, jonka toinen käyttäjä on lukinnut muokattavakseen.
Määritelty RFC 4918
424
Failed Dependency
Pyyntö epäonnistui, koska toinen toiminto, josta se riippui, epäonnistui.
Milloin käytetään: WebDAV-erässä ne toiminnot, joita ei voitu suorittaa, koska aiempi saman pyynnön toiminto epäonnistui.
Määritelty RFC 4918
425
Too Early
Palvelin ei ota riskiä käsitellä pyyntöä, joka saatettaisiin toistaa.
Milloin käytetään: TLS 1.3:n early datana (0-RTT) lähetetyille pyynnöille, jotka hyökkääjä voisi toistaa. Asiakkaan pitää yrittää uudelleen, kun kättely on valmis.
Määritelty RFC 8470
426
Upgrade Required
Palvelin hylkää pyynnön nykyisellä protokollalla, mutta hyväksyisi sen, kun asiakas siirtyy uudempaan.
Milloin käytetään: Lähetetään Upgrade-otsakkeen kera, joka nimeää vaaditun protokollan, esimerkiksi uudemman HTTP- tai TLS-version.
Määritelty RFC 9110 §15.5.22
428
Precondition Required
Palvelin vaatii pyynnön olevan ehdollinen, esimerkiksi If-Match-otsakkeella.
Milloin käytetään: Pakottaa asiakkaat osoittamaan, mitä versiota ne muuttavat, jotta kaksi muokkausta ei voi huomaamatta kirjoittaa toistensa päälle.
Määritelty RFC 6585
429
Too Many Requests
Asiakas on lähettänyt liian monta pyyntöä tietyssä ajassa.
Milloin käytetään: Pyyntöjen rajoitus (rate limiting). Retry-After-otsake kertoo, kauanko odottaa; asiakkaiden pitää hidastaa eikä yrittää heti uudelleen.
Määritelty RFC 6585
431
Request Header Fields Too Large
Palvelin ei käsittele pyyntöä, koska sen otsakkeet tai yksi otsake ovat liian suuria.
Milloin käytetään: Useimmiten ylisuuri eväste tai liian monta evästettä yhdelle verkkotunnukselle. Sivuston evästeiden tyhjentäminen yleensä korjaa sen.
Määritelty RFC 6585
451
Unavailable For Legal Reasons
Palvelin estää pääsyn resurssiin oikeudellisen vaatimuksen vuoksi.
Milloin käytetään: Sisältö, joka on estetty oikeuden määräyksellä, viranomaisen pyynnöstä tai poistovaatimuksella yhdessä maassa. Numero viittaa romaaniin Fahrenheit 451.
Määritelty RFC 7725
5xx · Palvelimen virhe
500
Internal Server Error
Palvelin kohtasi odottamattoman tilan, joka esti sitä täyttämästä pyyntöä.
Milloin käytetään: Yleiskoodi kaatumiselle tai käsittelemättömälle poikkeukselle. Palvelimen omat lokit kertovat, mitä todella tapahtui; asiakas ei yleensä voi korjata sitä.
Määritelty RFC 9110 §15.6.1
501
Not Implemented
Palvelin ei tue toimintoa, jota pyynnön täyttäminen vaatii.
Milloin käytetään: Metodi, jota palvelin ei tunnista lainkaan. Toisin kuin 405, se tarkoittaa, ettei mikään tämän palvelimen resurssi tue sitä.
Määritelty RFC 9110 §15.6.2
502
Bad Gateway
Yhdyskäytävänä tai välityspalvelimena toimiva palvelin sai takanaan olevalta palvelimelta virheellisen vastauksen tai ei vastausta lainkaan.
Milloin käytetään: Nginxin, kuormantasaajan tai CDN:n takana oleva sovellus on kaatunut, käynnistymässä uudelleen tai tavoittamattomissa.
Määritelty RFC 9110 §15.6.3
503
Service Unavailable
Palvelin ei voi juuri nyt käsitellä pyyntöä, koska se on ylikuormittunut tai huoltokatkolla.
Milloin käytetään: Tilapäinen tila. Lähetä Retry-After-otsake, joka kertoo, milloin palata; hakukoneet pitävät 503:a tilapäisenä ja säilyttävät sivun.
Määritelty RFC 9110 §15.6.4
504
Gateway Timeout
Yhdyskäytävänä tai välityspalvelimena toimiva palvelin ei saanut ajoissa vastausta takanaan olevalta palvelimelta.
Milloin käytetään: Hidas tietokantakysely tai taustajärjestelmä, jolta vastaaminen kestää kauemmin kuin välityspalvelimen aikakatkaisu.
Määritelty RFC 9110 §15.6.5
505
HTTP Version Not Supported
Palvelin ei tue pyynnössä käytettyä HTTP:n pääversiota.
Milloin käytetään: Harvinainen, koska lähes jokainen palvelin puhuu HTTP/1.1:tä, HTTP/2:ta ja usein HTTP/3:a.
Määritelty RFC 9110 §15.6.6
506
Variant Also Negotiates
Palvelimen määritysvirhe läpinäkyvässä sisältöneuvottelussa: valittu variantti on itse määritetty neuvottelemaan, mikä johtaisi silmukkaan.
Milloin käytetään: Peräisin kokeellisesta sisältöneuvottelusta (RFC 2295), eikä sitä juuri koskaan näe.
Määritelty RFC 2295
507
Insufficient Storage
Palvelin ei pysty tallentamaan sitä, mitä pyyntö vaatii sen tallentavan.
Milloin käytetään: WebDAV-lähetys tai -kopiointi, kun levy tai käyttäjän tallennuskiintiö on täynnä.
Määritelty RFC 4918
508
Loop Detected
Palvelin keskeytti WebDAV-toiminnon, koska se havaitsi loputtoman silmukan.
Milloin käytetään: Pyyntö otsakkeella Depth: infinity sidosten läpi, jotka osoittavat takaisin toisiinsa.
Määritelty RFC 5842
510
Not Extended
Ei käytössäPyyntö tarvitsee lisälaajennuksia, joita palvelin vaatii ennen kuin täyttää sen.
Milloin käytetään: Peräisin HTTP Extension Frameworkista (RFC 2774), joka on sittemmin siirretty historialliseksi, ja rekisteri merkitsee koodin vanhentuneeksi. Älä lähetä sitä.
Määritelty RFC 2774
511
Network Authentication Required
Asiakkaan on todennettava itsensä saadakseen ylipäätään pääsyn verkkoon.
Milloin käytetään: Kirjautumisportaalien lähettämä, kuten hotellien tai lentokenttien Wi-Fi-kirjautumissivujen, jotka sieppaavat liikenteen, kunnes käyttäjä kirjautuu.
Määritelty RFC 6585