HTTP-metodit ilmaisevat aikomuksesi resurssia kohtaan; tilakoodit ovat palvelimen koodattu vastaus. Metodeissa on tärkeää kaksi ominaisuutta: safe (vain luku, ei sivuvaikutuksia) ja idempotent (toistaminen tuottaa saman tuloksen — tärkeää turvallisille uudelleenyrityksille).
| Metodi | Tarkoitus | Safe | Idempotent |
|---|
| GET | Lue resurssi | Yes | Yes |
| POST | Luo / laukaise toiminto | No | No |
| PUT | Korvaa resurssi | No | Yes |
| PATCH | Päivitä osittain | No | No* |
| DELETE | Poista resurssi | No | Yes |
| HEAD | Kuten GET, vain otsakkeet | Yes | Yes |
Idempotenssi-erottelu on käytännöllinen: koska PUT ja DELETE ovat idempotentteja, asiakas voi turvallisesti yrittää niitä uudelleen timeoutin jälkeen; ei-idempotentin POSTin uudelleenyritys riskeeraa kaksoiskappaleen luomisen (klassinen kaksoisveloitusbugi).
Tilakoodit ryhmitellään ensimmäisen numeronsa mukaan:
1xx Informational request received, continuing (100 Continue, 101 Switching)
2xx Success it worked (200 OK, 201 Created, 204 No Content)
3xx Redirection go elsewhere (301 Moved, 304 Not Modified)
4xx Client error YOUR request is wrong (400, 401, 403, 404, 429)
5xx Server error the SERVER failed (500, 502, 503, 504)
Tärkein raja on 4xx vs 5xx -jako: 4xx tarkoittaa, että asiakas lähetti jotain väärää (huono syöte, ei todennettu, ei löydy) — muuttumaton uudelleenyritys ei auta; 5xx tarkoittaa, että palvelin epäonnistui — uudelleenyritys (backoffilla) saattaa onnistua. Osaa arjen koodit ulkoa: 401 (ei todennettu) vs 403 (todennettu mutta ei sallittu), 404 (ei löydy), 429 (rajoitettu tahti), 500 (yleinen palvelinkaatuminen), 502/503/504 (bad gateway / ei saatavilla / gateway timeout — yleensä upstream- tai ylikuormaongelma).
Nämä koodit ovat yhteinen sopimus jokaisen asiakkaan ja palvelimen välillä, joten sujuvuutta täällä odotetaan keneltä tahansa, joka rakentaa tai käyttää API:ja. Haastattelijat tunnustelevat erotteluja, jotka paljastavat todellisen ymmärryksen: 401 vs 403, PUT vs PATCH ja erityisesti idempotenssi, joka suoraan määrää, ovatko uudelleenyritykset turvallisia — ydinhuolenaihe hajautetuissa järjestelmissä ja maksuvirroissa. Oikean tilakoodin palauttaminen tekee myös API:stasi ennustettavan ja saa välimuistit, proxyt ja asiakaskirjastot käsittelemään sitä oikein, joten tämä tieto muovaa hyvää API-suunnittelua, ei ole vain nippelitietoa.
Kirjasto IT-haastattelukysymyksiä yksityiskohtaisine vastauksineen — Juniorista Senioriin.
Lahjoita