Come si mappano i metodi HTTP sul CRUD, e cosa significano safe e idempotent?

Esempi

PUT /users/42 invia l'intera rappresentazione e la sostituisce; PATCH /users/42 invia solo i campi da cambiare (es. { "email": "[email protected]" }).

Safe vs idempotent

Sono due proprietà diverse:

• Safe — il metodo non modifica lo stato del server (sola lettura). GET, HEAD, OPTIONS sono safe.
• Idempotent — fare la stessa richiesta N volte ha lo stesso effetto di farla una volta. GET, PUT, DELETE, HEAD sono idempotenti.

Perché è importante

Gli intervistatori chiedono questo per capire se comprendi la semantica HTTP abbastanza bene da costruire API affidabili. La distinzione safe/idempotent non è accademica: governa direttamente ciò che client, proxy e CDN possono fare. I metodi safe possono essere messi in cache e prefetchati liberamente; i metodi idempotent possono essere ritentati automaticamente dopo un timeout di rete senza rischio di duplicare gli effetti collaterali — ed è per questo che un client può ritentare in sicurezza un PUT o un DELETE ma deve fare attenzione a ritentare un POST (potrebbe creare due ordini). L'errore classico è usare GET per innescare effetti collaterali (es. GET /users/42/delete), che rompe il caching e permette ai crawler di mutare dati per sbaglio. Scegliere il metodo giusto — e rispettarne il contratto di safety e idempotenza — è ciò che rende un'API prevedibile e sicura su cui costruire tooling.