HTTP status codet ryhmitellään viiteen luokkaan ensimmäisen numeronsa mukaan, ja oikean valitseminen antaa clientien reagoida oikein parsimatta bodyä.
2xx Success — the request worked
3xx Redirection — further action / resource moved
4xx Client error — the caller did something wrong
5xx Server error — the server failed
2xx
200 OK — yleinen onnistuminen (GET, PUT, PATCH).201 Created — resurssi luotiin (palauta Location-header).202 Accepted — hyväksytty asynkroniseen käsittelyyn, ei vielä valmis.204 No Content — onnistuminen ilman bodyä (yleinen DELETElle).4xx
400 Bad Request — virheellinen syntaksi tai epäkelpo input.401 Unauthorized — ei autentikoitu (ei/väärät tunnistetiedot).403 Forbidden — autentikoitu mutta ei sallittu.404 Not Found — resurssia ei ole olemassa.409 Conflict — ristiriita nykyisen tilan kanssa (esim. sähköposti jo käytössä).422 Unprocessable Entity — hyvin muodostettu mutta epäonnistuu validoinnissa.429 Too Many Requests — rate limited.5xx
500 Internal Server Error — odottamaton palvelinvika.503 Service Unavailable — väliaikaisesti alhaalla/ylikuormitettu.POST /users → 201 Created
Location: /users/42
DELETE /users/42 → 204 No Content
GET /users/999 → 404 Not Found
{ "error": "user not found" }
Keskeinen erottelu, jota haastattelijat luotaavat: 401 ("kuka olet?") vs. 403 ("tunnen sinut, mutta en") ja 400 (virheellinen syntaksi) vs. 422 (kelvollinen syntaksi, epäkelpo data).
Status codet ovat ensisijainen signaali REST-vastauksessa — clientit, proxyt, monitorointi ja retry-logiikka nojaavat niihin, joten niiden oikein saaminen on olennaista yhteentoimivuudelle. Yleinen epäonnistuminen on palauttaa 200 OK ja { "error": ... } -body: se pakottaa jokaisen clientin parsimaan bodyn tietääkseen onnistuiko kutsu, rikkoo geneerisen HTTP-työkalutuksen ja piilottaa virheet monitoroinnilta. Tarkat koodit ohjaavat myös automaattista käytöstä: 429 tai 503 kertoo hyvin rakennetulle clientille perääntyä ja uudelleenyrittää, kun taas 4xx sanoo "älä uudelleenyritä, korjaa pyyntö". Haastattelijat käyttävät tätä kysymystä tarkistaakseen, että ymmärrät HTTP:n sopimuksena etkä tyhmänä siirtokanavana, ja että erotat hienovaraiset parit (401/403, 400/422) oikein — tunnusmerkki jollekulle, joka on rakentanut ja käyttänyt oikeita API:ja.
Kirjasto IT-haastattelukysymyksiä yksityiskohtaisine vastauksineen — Juniorista Senioriin.
Lahjoita