Nouveaux produits

EasyAPI - API REST professionnelle pour Dolibarr (32 domaines du cœur) + MCP

mp23914d20260607102352

API REST professionnelle pour Dolibarr : 32 domaines du cœur avec permissions natives, idempotence, résilience, docs Scalar et serveur MCP pour agents IA.

290,00 €
HT

  • Auteur EasySoft Tech SL
  • Version du module 2.13.4
  • Date de sortie 07/06/2026
  • Accès aux mises à jour et aux téléchargements 1 an
  • Comment contacter l'assistance info@easysoft.es
  • Compatibilité Dolibarr V15+   -   PHP7.0 - 8.3
  • Dernière mise à jour 31/07/2026 18:39

Plus d'infos...

EasySoft Tech - Des solutions qui font avancer votre entreprise

L'API REST que Dolibarr devrait fournir en standard

32 domaines du cœur avec les permissions natives de Dolibarr, une vraie idempotence et des opérations en masse. Avec un serveur MCP pour connecter des agents IA.

32
domaines du cœur
697
opérations
3 849
tests
V15–V23
PHP 7.0 à 8.3

Le problème qu'il résout

L'API native de Dolibarr ne se contente pas d'être limitée : chacune de ses bizarreries vous coûte des heures. Voici celles qui reviennent dans chaque intégration.

Ce que vous rencontrez Ce que ça vous coûte
Un POST renvoie un entier, un autre l'objet Un parseur différent par endpoint, et aucun réutilisable
Le join des commerciaux utilise t.rowid = sc.fk_soc Des tiers que cet utilisateur ne devrait pas voir se glissent dans les résultats
Un 401 arrive là où un 403 s'imposait Votre logique de réessai s'acharne sur quelque chose qui ne marchera jamais
accountancy n'expose que exportData La comptabilité reste en dehors de votre intégration
Aucune idempotence sur les écritures Un timeout, un réessai, et vous facturez deux fois

EasyAPI n'est pas une couche par-dessus l'API native : c'est une réimplémentation complète avec un contrat déclaratif uniforme.

NOUVEAUTÉ 2.1

Serveur MCP natif pour agents IA

Connectez Claude, Cursor ou n'importe quel agent IA à votre Dolibarr en une minute : l'URL du module et votre DOLAPIKEY comme jeton Bearer.

Au lieu de déverser des centaines d'outils sur l'agent, il expose trois méta-outils —search, describe et invoke— sur les 697 opérations, avec schémas et exemples prêts à l'emploi. L'agent enchaîne des opérations en plusieurs étapes, écrit avec idempotence et reçoit des erreurs auto-correctrices : un 422 lui indique le champ exact à corriger.

Il hérite de vos permissions et ACL natives de Dolibarr : il ne peut donc rien voir ni toucher que l'utilisateur ne pourrait pas. Onglet d'administration « MCP / IA » et guide de connexion inclus dans le module lui-même.

Documentation intégrée

La spécification OpenAPI se génère toute seule à partir des ressources et est servie dans le module, filtrée selon les permissions de l'utilisateur qui la consulte. Vous choisissez la visionneuse : Scalar, Swagger UI ou Redoc, les trois incluses.

Documentation d'EasyAPI avec Scalar : navigation par domaines, selecteur de serveur et authentification par DOLAPIKEY
Les 32 domaines navigables, avec sélecteur de serveur et authentification par DOLAPIKEY. Chaque opération apporte son schéma et un exemple prêt à l'emploi.

Comparatif face à l'API native

Dimension API native de Dolibarr EasyAPI
Couverture ~25 classes à la couverture inégale ; méthodes commentées ou inexistantes 32 domaines du cœur complets + sous-ressources
Réponses Hétérogènes : un POST renvoie un int, un autre l'objet Enveloppe uniforme {success, data}, avec meta.pagination dans les listes · POST → 201 + objet · DELETE → 204
Erreurs Codes et messages disparates, sans taxonomie ni request_id Catalogue complet (422, 409, 410, 412, 413, 415, 428, 429, 503…) avec request_id et doc_url
Sécurité Droits natifs, mais avec de vrais bugs d'ACL et des codes incorrects Mêmes droits natifs, ACL par enregistrement corrigée et uniforme, sans fuite entre entités
Idempotence N'existe pas Idempotency-Key avec réservation atomique et rejeu sur toute écriture
Validation 400 avec « champ manquant » 422 déclarative avec error.fields par règle
Requêtes sqlfilters + limit/page Filtres JSON:API, tri, recherche, sparse fields, include, pagination offset et curseur
Bulk N'existent pas 207 Multi-Status en création, mise à jour et suppression (100 par lot)
Résilience N'existe pas Rate-limit, réessai des deadlocks, ETag / If-Match, mode maintenance, /health
Documentation Explorateur Swagger basique OpenAPI complet avec Scalar, Swagger UI et Redoc intégrés
Extensibilité Il faut toucher ou forker le cœur Auto-découverte des ressources depuis votre propre module
Agents IA Non prévu Serveur MCP natif inclus

Comment ça s'utilise

Authentification avec votre DOLAPIKEY Dolibarr. Chaque réponse arrive avec la même enveloppe : votre client s'écrit une fois et vaut pour les 32 domaines.

CRÉER UNE FACTURE, SANS DOUBLON MÊME EN CAS DE RÉESSAI
curl -X POST https://votre-dolibarr.com/custom/easyapi/api/invoices \
  -H "DOLAPIKEY: votre_cle" \
  -H "Idempotency-Key: commande-4417" \
  -H "Content-Type: application/json" \
  -d '{"socid": 128, "lines": [{"fk_product": 55, "qty": 2}]}'

La route de base est custom/easyapi/api sur une installation standard. Si vous avez le module dans un autre dossier de modules déclaré dans votre conf.php, remplacez custom par le vôtre : EasyAPI n'a pas de chemins figés, il s'adapte à l'endroit où vous l'installez.

201 CREATED
{
  "success": true,
  "data": {
    "id": 902,
    "ref": "FA2607-0043"
  }
}
422 — IL VOUS DIT QUOI CORRIGER
{
  "success": false,
  "error": {
    "type": "validation_error",
    "code": 422,
    "message": "Validation failed",
    "fields": {
      "socid": "does not exist"
    },
    "request_id": "req_a1b2",
    "doc_url": "…#validation_error"
  }
}

Les listes ajoutent un bloc meta.pagination avec le mode (offset ou curseur), le total et la page. Et toute réponse, en succès comme en erreur, porte l'en-tête X-Request-Id : si quelque chose échoue, cet identifiant nous permet de tracer votre requête précise.

Ce qu'il contient

Vous étendez l'API sans toucher au cœur
Ressources auto-découvertes avec filtres JSON:API, tri, recherche, sparse fields, include et pagination par offset ou curseur. Vous étendez l'API depuis votre propre module sans toucher au cœur.
Des écritures sûres et des erreurs qui s'expliquent toutes seules
Idempotence par Idempotency-Key, validation 422 déclarative, erreurs structurées avec request_id, opérations en masse 207 et ACL par enregistrement.
Il encaisse les pics, les coupures et les réessais
Rate-limit configurable, réessai automatique des deadlocks, ETag et If-Match pour la concurrence optimiste, mode maintenance et endpoints /status et /health.
Une documentation qui ne se périme pas
OpenAPI complet avec Scalar, Swagger UI et Redoc intégrés, groupé par domaine et avec des exemples automatiques. Interface du module en 8 langues.

À quoi ça sert

  • Intégrer Dolibarr avec un e-commerce, des applis mobiles ou des ERP externes via une REST moderne.
  • Synchronisation en masse de produits, tiers et commandes par lots de 100.
  • Automatisations headless avec garantie d'exécution exactement une fois.
  • Alimenter la BI et les tableaux de bord avec de vrais filtres et une vraie pagination.
  • Donner à un agent IA un accès sûr et audité à votre ERP.
  • Construire votre propre API métier en étendant les ressources, sans forker Dolibarr.

Mise en route

1
Installez et activez EasyAPI, puis lancez composer install dans le dossier du module.
2
Configurez la résilience et le CORS dans l'onglet « API » : rate-limit, réessais, ETag et mode maintenance.
3
Authentifiez-vous avec votre DOLAPIKEY et consommez les 32 domaines avec Idempotency-Key et If-Match.
4
Ouvrez /docs pour explorer l'API, et l'onglet « MCP / IA » pour connecter votre agent.

Prérequis

Dolibarr V15 à V23
PHP 7.0 à 8.3
Base de données MySQL 5.7+ · MariaDB 10.2+ · PostgreSQL 10+
Serveur web Apache avec mod_rewrite ou Nginx
Dépendances Composer pour installer les bibliothèques du module

Avant d'acheter

Puis-je l'adapter à mon cas ?
Oui. EasyAPI est distribué sous GNU GPL v3 : vous recevez tout le code source et vous pouvez le lire, le modifier et l'adapter à votre installation sans demander la permission. De plus, le framework auto-découvre les ressources : le plus naturel est d'ajouter vos propres endpoints depuis votre module plutôt que de toucher au nôtre.
Comment le tester sans risquer mes données ?
Installez-le sur une copie de votre Dolibarr et appelez GET /status : il répond sans toucher un seul enregistrement. À partir de là, toutes les lectures (les 32 domaines avec filtres et pagination) sont inoffensives. Les écritures, elles, créent de vraies données : testez-les sur cette copie. Ce que garantit Idempotency-Key, c'est qu'un réessai après une coupure réseau ne duplique pas l'enregistrement, pas que l'opération soit réversible.
Et si quelque chose ne colle pas avec mon installation ?
Écrivez-nous à info@easysoft.es avant d'acheter et nous regardons ça avec vous : version de Dolibarr, PHP, hébergement et ce que vous devez intégrer. Nous préférons vous dire que ça ne convient pas plutôt que de vous vendre quelque chose d'inutile.
Et si je mets à jour ? Mon intégration va-t-elle casser ?
Non. EasyAPI est une API v1 stable et chaque réponse le déclare dans l'en-tête X-EasyAPI-Version. Seuls des changements rétrocompatibles entrent dans v1 : nouveaux champs optionnels, nouveaux endpoints, nouveaux en-têtes. Un changement qui casse le contrat —renommer un champ, changer un type— n'atterrit pas dans v1 : il sortirait en v2, et votre intégration continuerait de pointer vers v1 le temps de migrer quand ça vous arrange.
Que comprend l'achat ?
Le module complet avec son code source et 365 jours d'accès aux mises à jour et aux téléchargements depuis Dolistore, plus un support par e-mail pour l'installation, l'intégration et la connexion d'agents IA.

Maintenance active

EasyAPI n'est pas un module publié puis oublié. La version actuelle est la 2.13 et chaque livraison passe par la suite de 4 110 tests plus une QA en direct. La dernière série a transformé la spécification en un vrai contrat et supprimé le N+1 des listes, sans casser la compatibilité :

  • Contrat OpenAPI prêt pour la génération de code : listes typées avec leur pagination réelle et required, nullable et enum honnêtes. Votre client génère ses types au lieu de les écrire à la main.
  • Fini le N+1 : le tiers du document arrive dans le même appel sur 13 ressources, tout comme ses lignes et ses règlements, et l'on peut désormais trier et filtrer par champs du tiers.
  • Nouveaux endpoints métier : KPI de facturation, stock valorisé par entrepôt, définitions d'extrafields pour formulaires dynamiques, mouvements de tous les comptes bancaires et dictionnaires de tickets.
  • Serveur MCP conforme à la spécification 2025-11-25, avec transport STDIO et recherche multilingue pour les agents IA.

Le détail version par version est dans le ChangeLog, accessible depuis l'onglet d'administration du module.

24
modules publiés sur Dolistore
GPLv3
code source complet
8
langues dans l'interface
365
jours de mises à jour

Est-ce que ça colle à ce que vous devez intégrer ?

Racontez-nous votre cas et nous vous dirons si EasyAPI vous convient — et sinon, nous vous le dirons aussi. Nous répondons sur l'installation, l'intégration et la connexion d'agents IA.

info@easysoft.es www.easysoft.es



If you think this module is a fork of another one (published after the first one) or violates some terms or conditions of use (for users or vendors), you can make a report at dolistore@dolibarr.org