Éviter les opérations en double

L’idempotence est une technique qui garantit qu’une opération n’a lieu qu’une seule fois, quel que soit le nombre de fois où la même requête est relancée. Elle permet d’éviter les doublons lorsqu’une connexion est interrompue au milieu d’un POST.

État actuel : l’API v1 de Cord n’expose pas encore d’en-tête Idempotency-Key. En attendant son ajout, utilisez les stratégies suivantes pour éviter les doublons depuis votre intégration.

Stratégies recommandées

• Conservez l’id de la réponse. Lorsque vous créez un devis (POST /api/v1/cotizaciones), la réponse contient data.id et data.folio. Enregistrez-les dans votre système et ne relancez pas la requête si vous disposez déjà d’un id pour cette opération logique.
• Vérifiez avant de relancer. Si un POST échoue pour cause de délai dépassé, lancez d’abord un GET (par exemple la liste des devis récents) pour vérifier si la création a bien eu lieu avant de la renvoyer.
• Tirez parti du dédoublonnage de l’importateur. L’import de clients déduplique par RFC ou par nom, et celui de produits par SKU. Si vous synchronisez des catalogues, réimporter ne crée pas de doublons.

Lorsque nous publierons la prise en charge officielle de Idempotency-Key, nous mettrons à jour ce guide avec l’en-tête et ses règles.