Idempotence
Réessayez sans risque : la même requête avec la même clé ne s'exécute jamais deux fois.
Clés d'idempotence
Les actions qui envoient des courriels ou créent des dossiers exigent un en-tête Idempotency-Key : créer un document, l'envoyer, l'annuler, envoyer un rappel, et créer ou renouveler une clé d'API. Utilisez une nouvelle valeur aléatoire (un UUID est idéal) pour chaque action, et la même valeur quand vous la réessayez.
- Même clé, même corps : vous recevez de nouveau la première réponse, avec l'en-tête Idempotent-Replayed: true. Rien n'est répété.
- Même clé, corps différent : 409 idempotency_key_reused.
- Pendant que la première requête est encore en cours : 409 request_in_progress.
- Si la première requête a échoué, la clé est libérée : réessayer avec elle relance la requête.