Metodat HTTP shprehin qëllimin tënd mbi një resource; status code-t janë përgjigjja e koduar e serverit. Dy veti kanë rëndësi për metodat: safe (vetëm-lexim, pa efekte anësore) dhe idempotent (përsëritja e saj jep të njëjtin rezultat — e rëndësishme për retry të sigurt).
| Metoda | Qëllimi | Safe | Idempotent |
|---|
| GET | Lexo një resource | Yes | Yes |
| POST | Krijo / nis një veprim | No | No |
| PUT | Zëvendëso një resource | No | Yes |
| PATCH | Përditëso pjesërisht | No | No* |
| DELETE | Hiq një resource | No | Yes |
| HEAD | Si GET, vetëm header | Yes | Yes |
Dallimi i idempotency-së është praktik: meqë PUT dhe DELETE janë idempotent, një klient mund t'i bëjë retry në mënyrë të sigurt pas një timeout-i; retry-i i një POST jo-idempotent rrezikon të krijojë një dublikatë (një bug klasik i faturimit të dyfishtë).
Status code-t grupohen sipas shifrës së tyre të parë:
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)
Rreshti më i rëndësishëm është ndarja 4xx vs 5xx: 4xx do të thotë që klienti dërgoi diçka të gabuar (input i keq, jo i autentikuar, jo i gjetur) — retry-i pa ndryshime nuk ndihmon; 5xx do të thotë që serveri dështoi — retry-i (me backoff) mund të ketë sukses. Njihi përmendësh ato të përditshmet: 401 (jo i autentikuar) vs 403 (i autentikuar por jo i lejuar), 404 (jo i gjetur), 429 (i kufizuar në ritëm), 500 (crash gjenerik i serverit), 502/503/504 (bad gateway / i padisponueshëm / gateway timeout — zakonisht një problem upstream ose mbingarkese).
Këto kode janë kontrata e përbashkët midis çdo klienti dhe serveri, kështu që rrjedhshmëria këtu pritet nga kushdo që ndërton ose konsumon API. Intervistuesit hetojnë dallimet që zbulojnë të kuptuar të vërtetë: 401 vs 403, PUT vs PATCH, dhe sidomos idempotency, që drejtpërdrejt përcakton nëse retry-t janë të sigurt — një shqetësim thelbësor në sisteme të shpërndara dhe rrjedha pagesash. Kthimi i status code-it të duhur gjithashtu e bën API-në tënde të parashikueshme dhe të trajtuar saktë nga cache-t, proxy-t dhe bibliotekat e klientit, kështu që kjo njohuri formëson dizajn të mirë API-je, jo thjesht kuriozitet.
Një bibliotekë pyetjesh intervistash IT me përgjigje të detajuara — nga Junior te Senior.
Dhuro