Intégrer un module tiers à D-EDGE : cinq points au-delà de la documentation

Note d'atelier — 12 août 2026

La documentation officielle de l'API D-EDGE est solide, mais elle laisse dans l'ombre cinq points qui font toute la différence entre un branchement fonctionnel et un branchement robuste. Voici ce que la forge a appris en connectant nos 10 modules à des dizaines de comptes D-EDGE.

1. Les quotas ne sont pas partagés

Chaque clé API dispose de son propre quota (60 appels/minute). Si vous branchez plusieurs modules tiers sur la même clé, ils se partagent le quota et se bloqueront mutuellement en période de forte activité. Générez une clé par module.

2. Les fenêtres de maintenance D-EDGE ne sont pas exposées via l'API

Il faut lire les emails de notification D-EDGE ou aller sur leur page de statut publique. Un module bien conçu suspend automatiquement ses écritures pendant les fenêtres de maintenance annoncées.

3. Les rôles API sont plus fins que ce que suggère l'interface

Sous le capot, chaque endpoint requiert un scope spécifique. Un module qui écrit dans les restrictions tarifaires a besoin du scope rates.write mais pas de inventory.write. Ne surdimensionnez pas les droits.

4. La journalisation D-EDGE conserve 30 jours seulement

Au-delà, il faut rejouer depuis vos propres journaux. Nos modules DedgeCore conservent 90 jours par défaut pour combler ce trou.

5. La compatibilité v4.x n'est pas garantie sur v5

D-EDGE annonce ses versions majeures 90 jours à l'avance. Prévoyez une fenêtre de 30 jours pour tester votre module sur la nouvelle version, en environnement sandbox si D-EDGE le propose.