Line 25:
Line 25:
Quand ce module est activé, vous activez l'utilisation des Webservices fournis par Dolibarr. Vous pouvez alors faire des appels REST sur différents Webservices fournis par Dolibarr.
Quand ce module est activé, vous activez l'utilisation des Webservices fournis par Dolibarr. Vous pouvez alors faire des appels REST sur différents Webservices fournis par Dolibarr.
−
= Serveur de Web services REST Dolibarr =
+
= Installation =
+
+
Pour l'installer, ouvrez la page des modules et activez le module "API REST".
+
Une fois que le module Web services REST est activé, Dolibarr devient également un serveur de Web services REST. Vous pouvez alors envoyer vos propres requêtes sur l'url relative :
Une fois que le module Web services REST est activé, Dolibarr devient également un serveur de Web services REST. Vous pouvez alors envoyer vos propres requêtes sur l'url relative :
'''/api/index.php/xxx''' où xxx est l'API à appeler.
'''/api/index.php/xxx''' où xxx est l'API à appeler.
Line 33:
Line 36:
'''http://yourdolibarrurl/api/index.php/explorer'''.
'''http://yourdolibarrurl/api/index.php/explorer'''.
−
−
Vous devez au préalable faire un premier appel au service '''login''' pour obtenir une clé API.
−
Vous entrez alors la clé pour obtenir la liste des services proposés
Par exemple, vous pouvez essayer l'explorateur sur l'instance de démonstration à l'adresse suivante :
Par exemple, vous pouvez essayer l'explorateur sur l'instance de démonstration à l'adresse suivante :
Line 41:
Line 41:
'''https://demo.dolibarr.org/api/index.php/explorer'''
'''https://demo.dolibarr.org/api/index.php/explorer'''
−
Vous pouvez ensuite tester directement à partir de cet explorateur n'importe quelle API. Ceci est la solution recommandée pour tester toute API Dolibarr, car toutes les API et paramètres sont documentés ici. À la suite d'un test, vous obtiendrez la réponse, mais également un exemple sur la façon d'appeler l'API à partir de la ligne de commande à l'aide de curl.
+
Dans le coin supérieur droit, collez le <token> de l'utilisateur que vous souhaitez utiliser pour appeler l'API, puis cliquez sur le bouton "explorer". Remarque: Le jeton de chaque utilisateur peut être défini sur la page d'enregistrement de l'utilisateur.
−
= Installation =
+
Vous pouvez aussi préférer faire un premier appel au service '''login''' pour obtenir le jeton API. Vous entrez alors la clé pour obtenir la liste des services proposés.
−
Pour l'installer, ouvrez la page des modules et activez le module API REST. Sur la page de configuration du module, il y a un lien vers un explorateur. Cliquez dessus pour ouvrir l'explorateur d'API.
+
Après avoir cliqué sur "Explore", vous devriez voir toutes les actions disponibles avec ce jeton. Si vous n'avez pas beaucoup d'actions, c'est probablement parce que les modules correspondants ne sont pas activés. Si vous voulez voir les factures, vous devez activer le module Factures dans la configuration de Dolibarr. Même chose pour les Produits, les Tiers, etc.
−
Dans le coin supérieur droit, collez le <token> de l'utilisateur que vous souhaitez utiliser pour appeler l'API, puis cliquez sur le bouton "explorer". Remarque: Le jeton de chaque utilisateur peut être défini sur la page d'enregistrement de l'utilisateur.
+
Vous pouvez ensuite tester directement à partir de cet explorateur n'importe quelle API. Ceci est la solution recommandée pour tester toute API Dolibarr, car toutes les API et paramètres sont documentés ici. À la suite d'un test, vous obtiendrez la réponse, mais également un exemple sur la façon d'appeler l'API à partir de la ligne de commande à l'aide de curl.
−
−
Après avoir cliqué sur "Explorer", vous devriez voir toutes les actions disponibles avec ce jeton. Si vous n'avez pas beaucoup d'actions, c'est probablement parce que les modules correspondants ne sont pas activés. Si vous voulez voir les factures, vous devez activer le module Factures dans la configuration de Dolibarr. Même chose pour les Produits, les Tiers, etc.
Sur cette page d'exploration de l'API, vous pouvez faire beaucoup de tests. Lire des données de Dolibarr et écrire, modifier et supprimer également. Attention: les données sont vraiment modifiées dans votre base de données.
Sur cette page d'exploration de l'API, vous pouvez faire beaucoup de tests. Lire des données de Dolibarr et écrire, modifier et supprimer également. Attention: les données sont vraiment modifiées dans votre base de données.