Status kode HTTP so po prvi števki razvrščene v pet razredov, izbira prave pa odjemalcem omogoča pravilno reakcijo brez razčlenjevanja telesa (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 — splošen uspeh (GET, PUT, PATCH).201 Created — vir je bil ustvarjen (vrni glavo Location).202 Accepted — sprejeto za asinhrono obdelavo, še ni dokončano.204 No Content — uspeh brez telesa (pogosto za DELETE).4xx
400 Bad Request — napačna sintaksa ali neveljaven vhod.401 Unauthorized — ni avtenticiran (brez/neveljavne poverilnice).403 Forbidden — avtenticiran, a nima dovoljenja.404 Not Found — vir ne obstaja.409 Conflict — v sporu s trenutnim stanjem (npr. podvojena e-pošta).422 Unprocessable Entity — dobro oblikovan, a ne prestane validacije.429 Too Many Requests — omejen s hitrostjo (rate limited).5xx
500 Internal Server Error — nepričakovana napaka strežnika.503 Service Unavailable — začasno nedosegljiv/preobremenjen.POST /users → 201 Created
Location: /users/42
DELETE /users/42 → 204 No Content
GET /users/999 → 404 Not Found
{ "error": "user not found" }
Ključna razlika, ki jo spraševalci načnejo: 401 ("kdo si?") proti 403 ("poznam te, a ne"), in 400 (napačna sintaksa) proti 422 (veljavna sintaksa, neveljavni podatki).
Status kode so glavni signal v odgovoru REST — odjemalci, proxyji, nadzor (monitoring) in logika ponovnih poskusov se vsi ravnajo po njih, zato je pravilna izbira bistvena za interoperabilnost. Pogosta napaka je vračanje 200 OK s telesom { "error": ... }: vsakega odjemalca prisili k razčlenjevanju telesa, da izve, ali je klic uspel, pokvari splošna orodja HTTP in skrije napake pred nadzorom. Natančne kode poganjajo tudi samodejno vedenje: 429 ali 503 dobro zgrajenemu odjemalcu poveta, naj se umakne in poskusi znova, medtem ko 4xx pravi "ne ponavljaj, popravi zahtevo". Spraševalci s tem vprašanjem preverijo, ali razumete HTTP kot pogodbo in ne kot neumen prenosni kanal ter ali pravilno ločite tanke pare (401/403, 400/422) — znak nekoga, ki je gradil in uporabljal resnične API-je.
Knjižnica IT vprašanj za razgovore s podrobnimi odgovori — od začetnika do izkušenega.
Doniraj