Aller au contenu principal

Architecture

Idempotence

L'idempotence désigne la propriété d'une opération qui produit le même résultat quel que soit le nombre de fois où elle est exécutée. En HTTP, un PUT est idempotent (créer ou remplacer une ressource), un POST ne l'est pas (créer à chaque appel). C'est un concept fondamental dès qu'un traitement peut être rejoué : webhooks, imports, synchronisations, files de messages.

Pourquoi c'est critique

Les pannes réseau provoquent des retries automatiques, les webhooks peuvent être livrés plusieurs fois, les imports sont relancés après un incident. Sans idempotence, chaque rejeu risque de créer des doublons, un double débit ou un stock décrémenté deux fois.

Implémentation

Les techniques classiques : une clé d'idempotence envoyée par l'appelant, l'enregistrement des identifiants d'événements déjà traités, les opérations upsert fondées sur une clé métier unique, et des contraintes d'unicité en base comme dernier filet.

Le principe à retenir

Dans un système distribué, la livraison « exactement une fois » n'existe pas en pratique. Un message est livré au moins une fois, ou au plus une fois — et perdre des messages est rarement acceptable. On accepte donc qu'un même événement arrive plusieurs fois, et on rend son traitement idempotent. Ce n'est pas une optimisation : c'est la condition pour pouvoir rejouer un traitement en confiance après une panne.

Il ne faut pas confondre idempotence et dédoublonnement. L'idempotence est une garantie de correction : traiter deux fois le même message ne produit pas d'effet indésirable. Le dédoublonnement est une optimisation : on évite de traiter des messages devenus obsolètes. Les deux se combinent souvent.

Comment je l'applique

Des exemples concrets

Sur le hub de commandes d'une plateforme SaaS PIM/DAM, les commandes provenant des marketplaces sont importées de manière idempotente : si l'import est relancé après une panne réseau ou un timeout, les commandes déjà présentes sont mises à jour sans être dupliquées. Les stocks suivent le même principe, par lots, avec un historique de chaque mouvement pour tracer les écarts.

Sur un audit de charge pour Qezako, un réimport du même fichier CSV, sans aucune modification, purgeait le cache d'étiquettes de toutes les fiches : l'import recréait systématiquement les objets enfants, que l'ORM considérait comme modifiés. L'opération donnait le bon résultat, mais son effet de bord n'était pas idempotent. Une comparaison d'empreinte normalisée avant écriture a ramené un réimport identique à quelques secondes de lecture, sans écriture ni purge.

Les pièges à éviter

L'idempotence, c'est ce qui sépare les intégrations fragiles des intégrations résilientes — la différence entre « ça marche » et « ça tient en production ».

L'idempotence est une exigence de base de toutes mes synchronisations entre ERP et e-commerce. Pour les webhooks, voir aussi Webhooks ou polling : quelle architecture pour le temps réel.

Contact

Un projet en lien avec idempotence ?

Échangeons sur vos enjeux techniques. Pas de discours commercial, pas de jargon inutile : un diagnostic clair et des solutions concrètes.

Démarrer votre projet arrow_forward