Hogyan képződnek le a HTTP metódusok CRUD-ra, és mit jelent a safe és az idempotent?

Példák

A PUT /users/42 a teljes reprezentációt küldi, és lecseréli; a PATCH /users/42 csak a módosítandó mezőket küldi (pl. { "email": "[email protected]" }).

Safe vs idempotent

Ez két különböző tulajdonság:

• Safe — a metódus nem módosítja a server állapotát (csak olvas). A GET, HEAD, OPTIONS safe.
• Idempotent — ugyanazt a kérést N-szer elküldeni ugyanazzal a hatással jár, mint egyszer. A GET, PUT, DELETE, HEAD idempotent.

Miért fontos

Az interjúztatók azért kérdezik ezt, hogy lássák, elég jól érted-e a HTTP-szemantikát megbízható API-k építéséhez. A safe/idempotent megkülönböztetés nem akadémiai: közvetlenül szabályozza, mit tehetnek a kliensek, proxyk és CDN-ek. A safe metódusok szabadon cache-elhetők és előre letölthetők; az idempotent metódusok egy hálózati timeout után automatikusan újrapróbálhatók anélkül, hogy megduplázódnának a mellékhatások — ezért próbálhat újra egy kliens biztonságosan egy PUT-ot vagy DELETE-et, de óvatosnak kell lennie egy POST újrapróbálásakor (két ordert hozhat létre). A klasszikus hiba a GET használata mellékhatások kiváltására (pl. GET /users/42/delete), ami elrontja a cache-elést, és engedi, hogy a crawlerek véletlenül módosítsák az adatokat. A helyes metódus kiválasztása — és a safe/idempotent szerződésének tiszteletben tartása — az, ami kiszámíthatóvá és tooling építésére biztonságossá tesz egy API-t.