Si përputhen HTTP methods me CRUD, dhe çfarë do të thonë safe dhe idempotent?

Shembuj

PUT /users/42 dërgon të gjithë representation-in dhe e zëvendëson atë; PATCH /users/42 dërgon vetëm fushat që duhen ndryshuar (p.sh. { "email": "[email protected]" }).

Safe vs idempotent

Këto janë dy veti të ndryshme:

• Safe — metoda nuk e modifikon gjendjen e server-it (vetëm-lexim). GET, HEAD, OPTIONS janë safe.
• Idempotent — bërja e të njëjtit request N herë ka të njëjtin efekt si bërja e tij një herë. GET, PUT, DELETE, HEAD janë idempotent.

Pse ka rëndësi

Intervistuesit e pyesin këtë për të parë nëse i kupton semantikat e HTTP-së mjaftueshëm mirë sa për të ndërtuar API të besueshme. Dallimi safe/idempotent nuk është akademik: ai rregullon drejtpërdrejt çfarë u lejohet të bëjnë client-ëve, proxy-ve, dhe CDN-ve. Metodat safe mund të cache-ohen dhe prefetch-ohen lirisht; metodat idempotent mund të ribëhen (retry) automatikisht pas një network timeout pa rrezikun e dyfishimit të efekteve anësore — prandaj një client mund të ribëjë me siguri një PUT ose DELETE por duhet të jetë i kujdesshëm kur ribën një POST (mund të krijojë dy orders). Gabimi klasik është përdorimi i GET për të shkaktuar efekte anësore (p.sh. GET /users/42/delete), gjë që e prish caching-un dhe lejon crawler-at të ndryshojnë të dhëna aksidentalisht. Zgjedhja e metodës së duhur — dhe respektimi i kontratës së saj për safety dhe idempotency — është ajo që e bën një API të parashikueshëm dhe të sigurt për të ndërtuar tooling përreth.