HTTP methods hueleza nia yako kwenye resource; status codes ni jibu la server lililowekwa katika code. Sifa mbili zinajalisha kwa methods: safe (read-only, hakuna side effects) na idempotent (kuirudia hutoa matokeo yale yale — muhimu kwa retries salama).
| Method | Kusudi | Safe | Idempotent |
|---|
| GET | Soma resource | Yes | Yes |
| POST | Unda / anzisha hatua | No | No |
| PUT | Badilisha resource | No | Yes |
| PATCH | Sasisha kwa sehemu | No | No* |
| DELETE | Ondoa resource | No | Yes |
| HEAD | Kama GET, headers pekee | Yes | Yes |
Tofauti ya idempotency ni ya kivitendo: kwa sababu PUT na DELETE ni idempotent, client anaweza kuzirudia salama baada ya timeout; kurudia POST isiyo-idempotent huhatarisha kuunda nakala mbili (bug ya kawaida ya kutoza mara mbili).
Status codes hupangwa kwa tarakimu yao ya kwanza:
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)
Mstari muhimu zaidi ni mgawanyo wa 4xx dhidi ya 5xx: 4xx humaanisha client alituma kitu kibaya (input mbaya, hajathibitishwa, haipatikani) — kurudia bila kubadilisha hakutasaidia; 5xx humaanisha server ilishindwa — kurudia (kwa backoff) kunaweza kufanikiwa. Zijue vizuri za kila siku: 401 (hajathibitishwa) dhidi ya 403 (amethibitishwa lakini hakuruhusiwi), 404 (haipatikani), 429 (rate limited), 500 (crash ya jumla ya server), 502/503/504 (bad gateway / haipatikani / gateway timeout — kawaida tatizo la upstream au kuzidiwa).
Codes hizi ni mkataba wa pamoja kati ya kila client na server, hivyo ufasaha hapa hutarajiwa kwa yeyote anayejenga au kutumia APIs. Wahojiwa huchunguza tofauti zinazofunua uelewa halisi: 401 dhidi ya 403, PUT dhidi ya PATCH, na hasa idempotency, ambayo hutawala moja kwa moja kama retries ni salama — jambo la msingi katika mifumo iliyosambaa na mitiririko ya malipo. Kurudisha status code sahihi pia hufanya API yako itabirike na ishughulikiwe kwa usahihi na caches, proxies, na client libraries, hivyo maarifa haya huunda ubunifu mzuri wa API, si mambo madogo tu.
Maktaba ya maswali ya mahojiano ya IT yenye majibu ya kina — kutoka Junior hadi Senior.
Changia