Guide
Dolibarr : activer l'API REST pour un assistant IA
Relier un assistant IA à Dolibarr : module API REST, adresse /api/index.php, clé DOLAPIKEY, utilisateur dédié, explorateur, précautions.
Mis à jour le
Dolibarr est un ERP et CRM libre souvent installé par des petites structures. Un assistant IA qui doit retrouver un devis, une facture ou une fiche tiers passe par son API REST. Cette page reprend ce que dit le wiki des développeurs Dolibarr, lu le 16/11/2026. Elle ne couvre que ce qui s'y trouve : les droits fins par module et les versions précises sont à vérifier sur votre instance.
Comparez l’interface de Dolibarr à la documentation API d’ALMA pour préparer le rôle d’un assistant. Écrivez quelles données peuvent être lues, quelles opérations peuvent être proposées et où se situe leur validation par un utilisateur.
Activer le module
L'API n'est pas disponible tant que le module « API REST » n'est pas activé : on l'active depuis la page des modules de l'instance. Les appels se font ensuite sur l'adresse relative /api/index.php/xxx, où xxx est le nom de l'API. La forme générale est http://<votre_serveur>/api/index.php/<action>, avec les verbes GET, POST, PUT ou DELETE.
Obtenir une clé
Avant tout appel, il faut une clé d'API personnalisée. Le wiki procède ainsi : créer un utilisateur dédié, puis générer ou saisir sa « clé pour l'API » sur sa fiche. On peut aussi obtenir un jeton en appelant l'API de connexion.
La clé voyage dans un en-tête HTTP, sous la forme indiquée par le wiki : DOLAPIKEY: apikey. Un second en-tête facultatif, DOLAPIENTITY, désigne une entité quand le module multi-société est utilisé.
L'usage d'un utilisateur dédié compte : la clé est rattachée à un utilisateur, et il est prudent de supposer qu'elle ouvre les mêmes droits que lui (le wiki lu ne le détaille pas ; vérifiez sur votre instance). Pour un assistant, créez un utilisateur à part, avec uniquement les droits de lecture sur les modules dont il a besoin, puis ajoutez l'écriture plus tard. Cette consigne rejoint celle d'autres éditeurs, comme l'utilisateur robot d'Odoo cité sur la page IA et ERP. C'est une pratique à appliquer, que le wiki lu ne formule pas en ces termes.
L'explorateur
L'instance propose un explorateur interactif : http://votre-dolibarr/api/index.php/explorer. On y colle son jeton en haut à droite, puis on clique sur « explore ». Le wiki fournit aussi une instance de démonstration, avec un fichier Swagger à l'adresse explorer/swagger.json. Son jeton public « demokey » est réservé à cette démonstration : ne l'utilisez jamais sur un vrai système.
Précautions du wiki
- Les écritures sont réelles : « Data are really modified in your database », dit le wiki, à propos de l'explorateur comme de tout appel qui écrit ou supprime. Faites vos premiers essais sur une copie de la base.
- L'exemple de client PHP fourni n'est pas durci : le wiki indique qu'il n'y a ni contrôle d'erreur ni souci de sécurité, et qu'il faut l'adapter avant un usage réel.
- L'exemple de configuration Nginx contient un réglage de protection contre la faille « httpoxy ».
Vérifier le périmètre du compte
Sur une instance d’essai, préparez une fiche que le compte dédié doit pouvoir lire et une autre qui doit lui rester inaccessible. Testez les deux avec la même clé. Notez également le comportement d’une route d’écriture interdite : l’assistant doit savoir signaler le refus sans proposer un résultat qu’il n’a pas obtenu.
Ce que ce wiki ne dit pas
La page lue ne donne ni limite d'appels, ni liste complète des routes, ni durée de vie des clés, ni mécanisme de notification. Pour un assistant qui interroge Dolibarr à chaque question, mesurez vous-même ce que votre serveur supporte, et prévoyez une mise en cache. La méthode générale de passage en production est dans mise en production d'une intégration IA, le schéma de départ dans l'architecture type.
Le cadrage d'un assistant branché sur un ERP, du point de vue du prestataire, se lit sur Alaisia · Intégrateurs.
Questions fréquentes
Comment activer l'API REST de Dolibarr ?
En activant le module « API REST » depuis la page des modules, d'après le wiki Dolibarr.
Comment s'authentifier auprès de l'API Dolibarr ?
Avec l'en-tête HTTP DOLAPIKEY, qui contient la clé API de l'utilisateur. Cette clé se définit sur la fiche de l'utilisateur.
Peut-on tester l'API sans risque ?
L'explorateur de l'instance modifie réellement la base. Le wiki avertit que les données sont vraiment modifiées : testez sur une copie, pas sur la production.
Sources
Pages consultées pour écrire cet article :