Idempotency
Tutti gli endpoint di mutazionePOST e PATCH accettano un header facoltativo Idempotency-Key.
Quando inviarlo
Usa una chiave di idempotenza quando:- Un client potrebbe ritentare dopo un errore di trasporto.
- Un worker di coda potrebbe inviare la stessa operazione logica più di una volta.
- Un agente AI potrebbe rieseguire una mutazione dopo progressi parziali o retry degli strumenti.
Pattern consigliato
- Genera una chiave stabile per ciascuna mutazione logica.
- Riusa la stessa chiave per i retry di quella mutazione.
- Cambia la chiave quando cambia la mutazione desiderata.
Esempi
Buoni confini
- Una chiave per creare un progetto.
- Una chiave diversa per esportare quel progetto.
- Un’altra chiave diversa per aggiornare le impostazioni del progetto.