Rejouer une requête sans créer de doublon
Mise à jour : novembre 20264 min de lectureAPI v1
Un réseau coupe, un serveur redémarre. Avec une clé d'idempotence, vous renvoyez la même requête sans jamais créer deux factures.
1. La clé d'idempotence
Ajoutez l'en-tête Idempotency-Key (200 caractères au plus) à la création d'une facture, d'un avoir et à la finalisation. Choisissez une valeur liée à votre opération, par exemple le numéro de commande.
curl -X POST "$EINVOICING_API_BASE_URL/invoices" \ -H "Authorization: Bearer $EINVOICING_API_KEY" \ -H "Idempotency-Key: commande-4582" \ -H "Content-Type: application/json" -d @facture.json
2. Ce qui se passe au rejeu
3. Votre référence
Le champ sourceRef (app, type, id) désigne l'objet dans votre système. Une même référence ne crée jamais deux factures ; un contenu différent répond FISC-SOURCE-REFERENCE-CONFLICT (409).
4. Quand réessayer
Réessayez avec la même clé après une coupure réseau ou une réponse 5xx, en espaçant les essais (1 s, 2 s, 4 s…). Ne réessayez pas une réponse 4xx : corrigez d'abord la requête.