L'idempotence est la propriété d'une opération qui donne le même résultat qu'elle s'exécute une fois ou plusieurs fois, si bien que la répéter ne crée pas de doublons.
Intégration · Révisé par Ray Rasouli
Questions sur : Idempotence
Des réponses simples, adaptées à votre situation.
Posez n'importe quelle question sur idempotence. Par exemple, comment ça fonctionne dans vos outils actuels.
Un guide scénarisé pour l'instant. Il ne conserve pas ce que vous tapez.
Les réseaux ne sont pas fiables. Une intégration envoie "crée cette facture", la connexion coupe, et on ne sait pas si la facture a été faite. Si l'intégration réessaie et que l'opération n'est pas idempotente, vous avez maintenant deux factures et un client mécontent.
Une solution courante est la clé d'idempotence : un identifiant unique envoyé avec chaque requête. Si le système qui reçoit a déjà vu cet identifiant, il renvoie le résultat original au lieu de refaire le travail.
Pour un grossiste qui synchronise commandes et paiements, l'idempotence rend les nouvelles tentatives sûres, ce qui permet à l'intégration de se remettre seule des pépins.
En pratique
Les nouvelles tentatives créent des doublons.
Sans clé unique, chaque délai dépassé risque de créer une deuxième commande, un deuxième paiement ou une deuxième expédition.
La clé n'est pas vraiment unique.
Utiliser une date ou un nom de client comme clé fait entrer en collision des requêtes différentes.
Les clés expirent trop tôt.
Certains systèmes ne retiennent les clés que peu de temps, donc les tentatives tardives passent comme de nouvelles requêtes.
Les récepteurs de webhooks sautent la vérification.
Les expéditeurs livrent parfois le même événement plus d'une fois, et les récepteurs qui ne suivent pas les identifiants le traitent deux fois.
Tout ce qui crée ou déplace de l'argent ou des marchandises, comme les commandes, les paiements, les remboursements et les expéditions.
Par conception, oui. Lire des données ne devrait pas les changer, donc répéter un GET est sans danger.
Un appel découverte de 30 minutes avec Ray, puis une liste claire de ce qu'il faut corriger d'abord. Sans engagement.
Avec Ray Rasouli. Sans engagement.