Content-Type: application/json e un Idempotency-Key scelto dal chiamante. La chiave accetta 1–128 lettere ASCII, cifre e _.:/-. Il corpo della richiesta non può superare 256 KiB.
Idempotent-Replayed: true; una richiesta cambiata genera 409 idempotency_conflict. I permessi vengono verificati di nuovo anche sul replay.
La conservazione è limitata
I record di replay durano fino a 24 ore. Perdita o rimozione dei dati dallo storage possono ridurre la protezione. Non è un registro permanente che garantisce l’esecuzione una sola volta. Conserva il collegamento tra operazioni logiche e ID restituiti.Una modifica dall’esito incerto
Un timeout,5xx, request_in_progress o result_uncertain può indicare una modifica salvata senza risposta finale registrata.
- Rileggi la risorsa o cercala con un’identità esatta.
- Conserva richiesta e chiave originali durante la verifica.
- Non creare una chiave nuova solo per forzare un altro tentativo.
- Se l’esito resta ambiguo, condividi l’ID della richiesta con il referente.
mutation_may_have_succeeded e non riprovano automaticamente. Il dry-run della CLI valida in locale senza HTTP: non verifica lo stato corrente e non prenota una risorsa.