HTTPtilakoodien

HTTP-tilakoodit ovat HTTP-vastausviesteissä käytettyjä kolminumerorisia koodeja, joilla palvelin ilmaisee pyynnön käsittelyn tuloksen. Vastaus alkaa yleisesti protokollan version, tilakoodin ja syyilmoituksen (esim. “200 OK”) muodossa. Tilakoodit ovat standardoituja IETF:n dokumenteissa, erityisesti RFC 7231:ssa ja siihen liittyvissä julkaisuissa.

Tilakoodit jaotellaan viiteen pääryhmään: 1xx informatiiviset vastaukset, 2xx menestys, 3xx uudelleenohjaus, 4xx asiakkaan virheet ja 5xx palvelimen virheet. 1xx-vastaukset ovat harvinaisia; niihin kuuluu esimerkiksi 100 Continue ja 101 Switching Protocols. 2xx-koodit ilmaisevat, että pyyntö on onnistunut; yleisimpiä ovat 200 OK, 201 Created ja 204 No Content. 3xx-koodit ohjaavat asiakasta eteenpäin, kuten 301 Moved Permanently ja 302 Found, sekä 304 Not Modified, joka liittyy välimuistiin. 4xx-koodit kertovat asiakkaan virheestä, esimerkiksi 400 Bad Request, 401 Unauthorized, 403 Forbidden ja 404 Not Found. 5xx-koodit puolestaan osoittavat palvelimen virheen, kuten 500 Internal Server Error, 502 Bad Gateway, 503 Service Unavailable ja 504 Gateway Timeout.

Tilakoodit toimitetaan yleensä yhdessä muiden vastausotsikoiden kanssa ja niitä käytetään päätöksenteossa sekä käyttäjä- että palvelinsovelluksissa. Esimerkiksi 200 OK osoittaa, että pyyntö onnistui ja sisältöä seuraa, 204 No Content tarkoittaa, ettei vastauksessa ole viestisisältöä, ja 304 Not Modified liittyy ehdolliseen kyselyyn ja välimuistin hyödyntämiseen.