Úsáideann REST HTTP methods caighdeánacha mar na briathra a ghníomhaíonn ar acmhainní. Is é an mapáil choitianta go CRUD (Create, Read, Update, Delete):
Úsáideann REST HTTP methods caighdeánacha mar na briathra a ghníomhaíonn ar acmhainní. Is é an mapáil choitianta go CRUD (Create, Read, Update, Delete):
| CRUD | Method | Úsáid tipiciúil |
|---|
| Create | POST | Cuir acmhainn nua le collection |
| Read | GET | Faigh acmhainn nó liosta |
| Update (iomlán) | PUT | Cuir acmhainn ina hionad go hiomlán |
| Update (páirteach) | PATCH | Athraigh roinnt réimsí |
| Delete | DELETE | Bain acmhainn |
POST /users HTTP/1.1
Content-Type: application/json
{ "name": "Ann", "email": "[email protected]" }
HTTP/1.1 201 Created
Location: /users/42
{ "id": 42, "name": "Ann", "email": "[email protected]" }
Seolann PUT /users/42 an representation iomlán agus cuireann sé ina hionad é; seolann PATCH /users/42 na réimsí atá le hathrú amháin (m.sh. { "email": "[email protected]" }).
Is dhá airí éagsúla iad seo:
GET, HEAD, OPTIONS safe.GET, PUT, DELETE, HEAD idempotent.Method Safe? Idempotent?
GET yes yes
HEAD yes yes
PUT no yes (replacing with the same body twice = same result)
DELETE no yes (deleting twice = still deleted)
PATCH no no* (depends on the patch; not guaranteed)
POST no no (posting twice usually creates two resources)
Fiafraíonn agallóirí é seo chun a fheiceáil an dtuigeann tú séimeantaic HTTP go maith go leor chun APIanna iontaofa a thógáil. Ní acadúil an t-idirdhealú safe/idempotent: rialaíonn sé go díreach cad a cheadaítear do chliaint, do phroxies, agus do CDNanna a dhéanamh. Is féidir methods safe a chur i dtaisce agus a réamhfháil gan srian; is féidir methods idempotent a atriail go huathoibríoch tar éis network timeout gan riosca fo-iarmhairtí a dhúbailt — agus sin an fáth ar féidir le cliant PUT nó DELETE a atriail go sábháilte ach nach mór dó a bheith cúramach ag atriail POST (d'fhéadfadh sé dhá order a chruthú). Is é an botún clasaiceach GET a úsáid chun fo-iarmhairtí a spreagadh (m.sh. GET /users/42/delete), rud a bhriseann caching agus a ligeann do chrawlers sonraí a athrú de thaisme. Is é an method ceart a roghnú — agus meas a bheith agat ar a chonradh sábháilteachta agus idempotency — a fhágann go bhfuil API intuartha agus sábháilte chun tooling a thógáil timpeall air.
Leabharlann de cheisteanna agallaimh TF le freagraí mionsonraithe — ó Shóisearach go Sinsearach.
Síntiús