Idempotence
Tous les endpoints de mutationPOST et PATCH acceptent un en-tête optionnel Idempotency-Key.
Quand l’envoyer
Utilisez une clé d’idempotence lorsque :- Un client peut réessayer après une défaillance de transport.
- Un worker de file d’attente peut envoyer la même opération logique plus d’une fois.
- Un agent d’IA peut relancer une mutation après une progression partielle ou des nouvelles tentatives d’outil.
Modèle recommandé
- Générez une clé stable par mutation logique.
- Réutilisez la même clé pour les nouvelles tentatives de cette mutation.
- Changez la clé lorsque la mutation prévue change.
Exemples
Bonnes limites
- Une clé pour créer un projet.
- Une clé différente pour exporter ce projet.
- Une autre clé différente pour mettre à jour les paramètres du projet.