Distinguer requête répétée et effet répété
L’idempotence décrit un effet attendu identique lorsqu’une opération est répétée. Elle ne découle pas du simple fait d’utiliser une API. Une création de commande, une notification et une modification de champ peuvent avoir des conséquences différentes.
Après un délai d’attente dépassé, l’absence de réponse ne prouve pas l’absence d’exécution. Avant de relancer, il faut pouvoir rechercher l’opération ou utiliser une protection de déduplication adaptée.
Conserver un état de travail exploitable
| Élément | Utilité |
|---|---|
| Identifiant métier stable | Retrouver le même objet après une nouvelle tentative |
| Identifiant de tentative | Distinguer les essais d’un même travail |
| Étape confirmée | Savoir ce qui a déjà produit un effet |
| Erreur qualifiée | Distinguer donnée invalide, accès refusé et panne temporaire |
| Décision de reprise | Automatique, manuelle ou refusée selon le risque |
Tester l’interruption au milieu du parcours
Dans un scénario fictif, le contact est créé mais son rattachement échoue. La recette coupe l’opération à cet endroit puis la reprend. Elle vérifie qu’un seul contact existe et que l’association attendue finit dans un état explicite.
Ne relancer automatiquement que les erreurs et opérations prévues pour cela. Une donnée invalide ou un droit absent demande souvent une correction. Le journal de reprise garde les preuves nécessaires et masque les données inutiles au diagnostic.
Traiter le cas où le destinataire ne répond plus
Après une création dont la réponse a été perdue, recherchez d’abord l’objet avec une référence stable si l’API le permet. Si l’effet ne peut être ni retrouvé ni protégé contre la répétition, bloquez cette tentative pour revue. Ajouter davantage de reprises automatiques ne réduit pas cette ambiguïté.
Définissez une durée et un nombre de tentatives bornés, ainsi qu’une sortie manuelle avec responsable. La déduplication doit être cohérente avec la durée pendant laquelle un événement peut revenir. Dans la recette, vérifiez aussi un message répété après réussite et deux tentatives concurrentes ; la présence d’un identifiant dans un journal ne démontre pas à elle seule qu’un doublon est empêché.
Sources et périmètre des références
- IETF — HTTP Semantics, RFC 9110 — 2026-11-22