Cuireann HTTP methods in iúl do rún ar acmhainn; is iad status codes freagra códaithe an fhreastalaí. Tá dhá airí tábhachtach do methods: safe (léamh-amháin, gan fo-iarmhairtí) agus idempotent (má athdhéantar é tugann sé an toradh céanna — tábhachtach le haghaidh atriail shábháilte).
| Method | Cuspóir | Safe | Idempotent |
|---|
| GET | Léigh acmhainn | Tá | Tá |
| POST | Cruthaigh / spreag gníomh | Níl | Níl |
| PUT | Ionadaigh acmhainn | Níl | Tá |
| PATCH | Nuashonraigh go páirteach | Níl | Níl* |
| DELETE | Bain acmhainn | Níl | Tá |
| HEAD | Cosúil le GET, headers amháin | Tá | Tá |
Tá an t-idirdhealú idempotency praiticiúil: toisc go bhfuil PUT agus DELETE idempotent, is féidir le cliant iad a atriail go sábháilte tar éis timeout; tá baol ann le hatriail POST neamh-idempotent dúblach a chruthú (fabht dúbailte-mhuirir clasaiceach).
Grúpáiltear status codes de réir a gcéad digit:
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)
Is í an líne is tábhachtaí an scoilt 4xx i gcoinne 5xx: ciallaíonn 4xx gur sheol an cliant rud éigin mícheart (ionchur dona, gan fhíordheimhniú, gan aimsiú) — ní chuideoidh atriail gan athrú; ciallaíonn 5xx gur theip ar an fhreastalaí — d'fhéadfadh atriail (le backoff) éirí leis. Bíodh na cinn laethúla ar eolas go daingean agat: 401 (gan fhíordheimhniú) i gcoinne 403 (fíordheimhnithe ach gan cead), 404 (gan aimsiú), 429 (rátatheorannaithe), 500 (tuairt fhreastalaí ghinearálta), 502/503/504 (bad gateway / neamhinfhaighte / gateway timeout — fadhb upstream nó ró-ualaigh de ghnáth).
Is iad na cóid seo an conradh roinnte idir gach cliant agus freastalaí, mar sin táthar ag súil le líofacht anseo ó aon duine a thógann nó a itheann APInna. Scrúdaíonn agallóirí na hidirdhealuithe a nochtann fíorthuiscint: 401 i gcoinne 403, PUT i gcoinne PATCH, agus go háirithe idempotency, a rialaíonn go díreach an bhfuil atrialacha sábháilte — croí-imní i gcórais dáilte agus sreabha íocaíochta. Fágann an status code ceart a fhilleadh do API intuartha agus láimhseáilte i gceart ag caches, proxies, agus leabharlanna cliant, mar sin múnlaíonn an t-eolas seo dea-dhearadh API, ní hamháin fánaíocht.
Leabharlann de cheisteanna agallaimh TF le freagraí mionsonraithe — ó Shóisearach go Sinsearach.
Síntiús