A HTTP method-ok a szándékodat fejezik ki egy resource-on; a status code-ok a szerver kódolt válasza. A method-oknál két tulajdonság számít: safe (csak olvasás, mellékhatás nélkül) és idempotent (megismétlése ugyanazt az eredményt adja — fontos a biztonságos retry-hoz).
| Method | Cél | Safe | Idempotent |
|---|
| GET | Resource olvasása | Yes | Yes |
| POST | Létrehozás / művelet indítása | No | No |
| PUT | Resource lecserélése | No | Yes |
| PATCH | Részleges frissítés | No | No* |
| DELETE | Resource törlése | No | Yes |
| HEAD | Mint GET, csak headerek | Yes | Yes |
Az idempotencia megkülönböztetése gyakorlati: mivel a PUT és a DELETE idempotens, egy kliens biztonságosan retry-olhatja őket egy timeout után; egy nem idempotens POST retry-olása duplikátum létrehozásának kockázatával jár (a klasszikus kétszeres-terhelés bug).
A status code-ok az első számjegyük szerint csoportosulnak:
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)
A legfontosabb határvonal a 4xx vs 5xx felosztás: a 4xx azt jelenti, hogy a kliens küldött valami rosszat (hibás input, nem hitelesített, nem található) — változatlanul újrapróbálni nem segít; az 5xx azt jelenti, hogy a szerver hibázott — az újrapróbálás (backoff-fal) sikerülhet. A mindennapiakat tudd kívülről: 401 (nem hitelesített) vs 403 (hitelesített, de nincs engedélye), 404 (nem található), 429 (rate limitelve), 500 (általános szerverösszeomlás), 502/503/504 (bad gateway / nem elérhető / gateway timeout — általában upstream vagy túlterhelési probléma).
Ezek a kódok a közös szerződés minden kliens és szerver között, ezért az itteni folyékonyság elvárt mindenkitől, aki API-t épít vagy fogyaszt. Az interjúztatók azokat a megkülönböztetéseket firtatják, amelyek valódi megértést fednek fel: 401 vs 403, PUT vs PATCH, és különösen az idempotencia, amely közvetlenül szabályozza, hogy a retry-ok biztonságosak-e — alapvető szempont elosztott rendszerekben és fizetési folyamatokban. A helyes status code visszaadása kiszámíthatóvá is teszi az API-dat, és lehetővé teszi, hogy a cache-ek, proxy-k és kliens-könyvtárak helyesen kezeljék, így ez a tudás a jó API-tervezést formálja, nem csupán apró érdekesség.
IT interjúkérdések gyűjteménye részletes válaszokkal — Juniortól Seniorig.
Adományozás