FAQ Technique et API D-EDGE
Questions techniques sur l'intégration API D-EDGE, les scopes, la fréquence de synchronisation, la résolution d'erreurs. Pour les fonctions métier voir FAQ Modules.
API D-EDGE
Comment générer un jeton API dans mon compte D-EDGE ?
Dans votre extranet D-EDGE : Paramètres → Intégrations → API tokens → Nouveau jeton. Nommez-le pour rappeler l'usage (ex. « dedgetech-loyalty »). Sélectionnez les scopes listés dans les instructions envoyées post-achat par email. Le jeton est affiché une seule fois — copiez-le immédiatement.
Quels scopes API sont nécessaires pour chaque module ?
CRS Add-on : reservations.read, reservations.write, rates.read, availability.read. Channel Manager Extension : distribution.read, distribution.write, rates.write. Big Data : reservations.read, folio.read, marketing.read. Loyalty : guests.read, guests.write, marketing.write. Chaque module utilise le minimum nécessaire.
Puis-je limiter les scopes du jeton ?
Fortement recommandé. Accordez uniquement les scopes listés pour le(s) module(s) que vous activez. Si vous ajoutez un module plus tard, régénérez un jeton avec les scopes additionnels. La granularité de scope respecte le principe de least privilege.
Quelle est la limite d'API rate ?
D-EDGE applique des rate limits par tenant (typiquement 100 req/s en burst, 20 req/s en soutenu). Nos modules respectent ces limites nativement via un token bucket interne. Vous ne verrez jamais un module dégrader vos autres intégrations D-EDGE.
Y a-t-il une documentation API D-EDGE publique ?
La documentation officielle est distribuée par D-EDGE aux clients avec un compte API activé (contact commercial D-EDGE). Nos modules encapsulent cette API : vous n'avez pas besoin de la maîtriser pour utiliser dedgetech.org.
Erreurs et dépannage
Mon jeton est refusé lors de l'onboarding — pourquoi ?
Causes fréquentes : (1) scopes insuffisants — re-générez avec la liste complète ; (2) jeton copié avec un espace en fin ; (3) tenant D-EDGE hors service ; (4) module non-inclus dans votre plan D-EDGE (par ex. l'API n'est pas activée sur les plans Starter). Contactez-nous pour un check.
Un module renvoie « 429 Too Many Requests » — que faire ?
Notre couche de rate limiting devrait absorber cela. Si l'erreur persiste, c'est probablement une autre intégration D-EDGE qui sature votre quota. Consultez votre tableau de bord D-EDGE section API usage. Contactez D-EDGE pour un ajustement de quota si besoin.
Je vois des données désynchronisées entre le module et D-EDGE — pourquoi ?
Vérifiez le lag de sync du module concerné (documentation) : temps réel (Channel Manager) vs batch 15 min (Big Data) vs nocturne (enrichissements Loyalty). Si le délai est anormal, ouvrez un ticket — nos SLA garantissent une resync sous 5 min pour temps-réel.
Comment auditer les appels API entre le module et D-EDGE ?
Dans votre espace client dedgetech.org : section « Journal API ». Chaque appel est logé avec timestamp, endpoint, code réponse, durée. Rétention 90 jours. Export CSV disponible. En parallèle votre tableau de bord D-EDGE section API usage log les mêmes appels côté D-EDGE.
Support technique disponible en anglais ?
Oui. Support par email en français et anglais. Support téléphonique : français principal, anglais sur demande (ingénieur EN disponible sur créneau planifié). Horaires 09:00-19:00 CET/CEST du lundi au vendredi.