Aller au contenu

Idempotence

Une opération idempotente produit le même effet sur l’état, qu’elle soit exécutée une seule fois ou répétée à l’identique.

Également appeléIdempotency
API et contrats de données

L’idempotence signifie que répéter une opération identique produit le même effet prévu sur l’état du système qu’une exécution unique. Réponse et journaux ne doivent pas forcément être identiques.

Un appel ERP fictif crée W-240 avec la clé stable shop-1:W-240:create. Si la destination reconnaît cette clé de façon fiable, une répétition ne doit pas créer une deuxième commande. Portée, contenu et conservation doivent respecter les règles réellement prises en charge.

Une clé ignorée par le destinataire ne protège rien. Le nom de méthode HTTP ne prouve pas non plus la justesse métier de l’intégration. L’idempotence décrit l’effet de la répétition ; la stratégie de nouvelle tentative définit quand réessayer.

Sources