L'idempotence : rejouer sans doublon

Une opération est idempotente si la répéter produit le même résultat que la faire une fois. « Passer le statut à expédiée » l’est ; « créer une facture » ne l’est pas. Or tout, dans une architecture fiable, finit par se répéter : l’appelant renvoie un webhook, n8n rejoue une exécution, un humain relance un élément. Voici l’incident des doubles factures de Nadia, et la parade.

La clé d’idempotence est un identifiant métier stable : le numéro de commande, jamais l’heure de réception. Quand l’API appelée l’accepte, transmettez-la aussi. Stripe, par exemple, reconnaît l’en-tête Idempotency-Key : un second appel avec la même clé renvoie la réponse déjà produite au lieu de recréer l’objet.

Notez que l’incident avait deux causes : une réponse tardive au site, qui a provoqué le renvoi, et une facturation qui ne vérifiait rien. La carte suivante règle un dernier cas, plus subtil.