# Idempotence Une coupure réseau ne doit jamais créer deux demandes ni envoyer deux e-mails. Renvoyez la même requête avec le même `Idempotency-Key` : vous recevez la même réponse. ## Où l'en-tête est obligatoire `Idempotency-Key` (8 à 64 caractères, unique par opération) est exigé sur : - `POST /requests`, `PATCH /requests/{request_id}`, `DELETE /requests/{request_id}`, `POST /requests/{request_id}/confirmation` ; - `POST /agent/conversations` et `POST /agent/conversations/{conversation_id}/messages` ; - `POST /webhook-endpoints`. Les lectures et `POST /trade-matches` (lecture seule) n'en ont pas besoin. ## Rejeu | Situation | Réponse | | Même clé, même corps, sous 24 heures | la réponse d'origine, avec `Idempotent-Replayed: true` | | Même clé, corps différent | `422 idempotency_key_reused` | | Même clé, requête d'origine encore en cours | `409 idempotency_in_progress` : réessayez après quelques secondes | La clé est rattachée à votre compte et au mode (test ou live) : deux partenaires ne peuvent pas se gêner. ## Choisir ses clés Dérivez la clé de votre propre identifiant d'opération : `resa-0042-draft-1` pour le brouillon de la réservation 0042, `resa-0042-confirmation-1` pour sa confirmation. Pour recommencer volontairement une opération, changez le suffixe. ## Doublons de contenu Indépendamment de l'en-tête, une demande identique déjà en attente pour la même personne n'est pas recréée et ne déclenche aucun nouvel e-mail (`duplicate_request`, [erreurs](https://kelki.ai/developers/fr/errors/#duplicate_request)). ## Sur cette page - URL : https://kelki.ai/developers/fr/idempotency/ - Langue : fr - fr : https://kelki.ai/developers/fr/idempotency/ - en : https://kelki.ai/developers/en/idempotency/ - x-default : https://kelki.ai/developers/ - Portail : https://kelki.ai/developers/llms.txt