Inizia
Lettura
Leggi la risorsa prima di modificarla e invia expected_version come documentato.
Scrittura
Usa POST per creare le risorse supportate, PATCH per gli aggiornamenti parziali e DELETE per le eliminazioni supportate.
Risposta
La ripetizione di un’operazione riuscita restituisce il risultato salvato senza applicare nuovamente la modifica.
Header
- Idempotency-Key
- Ogni scrittura su una risorsa richiede Idempotency-Key. Genera una chiave per operazione logica; nei tentativi successivi mantieni chiave, metodo, destinazione e contenuto.
- expected_version
- Le modifiche dei prezzi possono richiedere anche versioni di prodotto, prezzo, prezzo della variante o listino. Se la versione cambia, rileggi i dati e riconcilia l’aggiornamento anziché imporre dati obsoleti.
Regola di ripetizione
- Riutilizzare la chiave per una richiesta diversa produce idempotency.key_reused.
- Gli esempi sono sintetici: prima di eseguirli, sostituisci gli identificativi con quelli del tuo negozio.