API : vue d'ensemble
DURUM.ai expose une API REST pour que vous puissiez lire vos propres données (dépenses publicitaires, attribution, funnel, événements, contacts, appels, parcours, besoins créatifs) depuis vos propres outils : un tableau de bord BI, un script, un entrepôt de données ou un outil d'agence.
Paliers payants
L'API REST et le serveur MCP sont réservés aux paliers payants (Starter, Growth, Scale). Sur le plan Découverte, toute requête répond 403 plan_free_no_api. Les clés se créent dans Paramètres, Réglages, Clés API.
Pour brancher un assistant IA (Claude, ChatGPT ou un autre client MCP), voir Serveur MCP.
En bref
| Base | https://app.durum.ai/api/v1/ |
| Authentification | en-tête Authorization: Bearer durum_sk_live_… |
| Lecture | 30 routes GET, paramètres dans la chaîne de requête |
| Écriture | 9 routes PUT ou POST, corps JSON, scopes write:* accordés explicitement |
| Réponse | 200 avec { "data": … } ; erreurs avec { "error": "…" } |
| Limite de débit | 600 requêtes par minute et par clé |
| Index | GET https://app.durum.ai/api/v1/ (avec la barre oblique finale) liste les routes et leur scope |
Le principe
Vous obtenez vos résultats (les chiffres). Le moteur d'optimisation de DURUM, les modèles d'IA, les prompts, les coûts internes et les marges ne sont jamais exposés : ces champs sont retirés de chaque réponse avant envoi.
Ce à quoi vous avez accès
| Domaine | Scope de lecture | Exemples |
|---|---|---|
| Dashboard | read:dashboard | KPI agrégés, série quotidienne, répartitions par source, campagne, produit, rep |
| Publicités | read:ads | dépenses par annonce et par campagne, règles d'ads et leur historique |
| Attribution | read:attribution | attribution multi-touch par annonce, santé de capture, rapport par source |
| Événements | read:events | leads, candidatures, RDV, no-show, ventes, paiements, annulations |
| Ventes | read:sales | résumé commercial, performance par rep, cycle de vente |
| Finance | read:finance | P&L et revenus (les marges ne sont pas exposées) |
| Funnel | read:funnel | étapes et conversion |
| Contacts | read:contacts | contacts, clients, achats |
| Appels | read:calls | liste des appels analysés, transcription, enregistrement |
| Parcours | read:journeys | parcours client avec l'UTM capté à chaque point de contact |
| Créatifs | read:creatives | besoins créatifs en attente |
| ICP | read:icp | vos critères de client idéal |
| Pixels | read:capi | vos pixels Meta connectés (jamais les jetons) |
Les écritures possibles (objectifs, règle de vente, critères ICP, règles d'ads, dépôt de créatifs, acquittement des besoins créatifs) sont détaillées dans la référence de l'API.
Sécurité et isolation
- Chaque clé est liée à un seul compte. Le compte est déduit de la clé côté serveur ; vous ne le transmettez jamais et vous ne pouvez pas lire les données d'un autre client.
- L'accès est granulaire : une clé n'atteint que les scopes qu'elle porte. Sans le scope, la route répond
403. - Lecture seule par défaut : une clé n'écrit rien tant qu'elle ne porte pas un scope
write:*. - Chaque requête authentifiée est journalisée (clé, méthode, chemin, scope, code de réponse, adresse IP).
- Les jetons, secrets, identifiants de modèles, coûts et marges sont retirés de toutes les réponses, à tous les niveaux d'imbrication.
Données personnelles (Loi 25 / RGPD)
L'API peut retourner des données de vos prospects (courriels, téléphones, transcriptions et enregistrements d'appels). Vous êtes responsable de l'usage que vous en faites conformément à la réglementation applicable.
Pour commencer
- Créez une clé dans Paramètres, Réglages, Clés API (palier payant requis).
- Lisez Authentification et clés API.
- Consultez la référence de l'API et testez :
curl "https://app.durum.ai/api/v1/dashboard/kpis?from=2026-08-01&to=2026-08-31" \
-H "Authorization: Bearer durum_sk_live_VOTRE_CLE"