Vous regardez une version antérieure (v. /confluence/display/BM35/API+BlueMind) de cette page.

afficher les différences afficher l'historique de la page

« Afficher la version précédente Vous regardez la version actuelle de cette page. (v. 2) afficher la version suivante »

L’API de BlueMind a été complètement repensée et est disponible soit directement via des appels HTTP REST, soit en utilisant des clients (aujourd’hui Java, Javascript, C#, Python et PHP). Le repository bluemind-samples est disponible et rassemble tout ce qui est nécessaire pour contribuer à BlueMind en développant un Add-On. Un archetype maven est également disponible pour faciliter la définition d’un nouveau projet.

Une documentation interactive de notre nouvelle API REST est embarquée dans l’installeur : il s'agit du paquet optionnel bm-docs. Une fois celui-ci installé, la documentation de l'API REST sera accessible aux utilisateurs disposant du droit “Api docs”. Cette documentation est également publiée dans l'espace BlueMind Docs.


Client généré Java

L'API et le client généré sont publiés comme artifacts Maven dans notre repository nexus. Il suffit de référencer le repository dans le pom.xml de votre projet maven:

<repositories>
    <repository>
        <id>bluemind</id>
        <name>Bluemind Releases</name>
        <url>http://pkg.blue-mind.net/mvn</url>
        <layout>default</layout>
    </repository>
</repositories>

et ajouter la dépendance suivante :

<dependency>
    <groupId>net.bluemind</groupId>
    <artifactId>net.bluemind.bm-api</artifactId>
    <version>3.1.20985</version>
</dependency>

Vous pouvez également télécharger l'artifact directement via l'URL : net.bluemind.bm-api-3.1.20985.jar

Vous pouvez trouver un exemple dans notre dépôt GIT bluemind-samples : https://forge.bluemind.net/stash/projects/BA/repos/bluemind-samples/browse/bm-api3.5-client

Client python

Le client python est généré automatiquement, puis distribué dans le paquet python-bm-client qui est accessible dans les dépôts BlueMind. Il supporte python-2.7 pour le moment.

Ce client est également publié sur les dépôts pypi, et peut donc être installé en utilisant le gestionnaire de paquets python pip. Voici un exemple qui permet d'obtenir un environnement fonctionnel qui s'abstrait du système hôte en utilisant virtualenv :

virtualenv bluemind-python-env
source bluemind-python-env/bin/activate
pip install netbluemind

L'environnement est alors fonctionnel pour interagir avec un serveur BlueMind !

Vous pouvez trouver des exemples dans notre dépôt GIT bluemind-samples : https://forge.bluemind.net/stash/projects/BA/repos/bluemind-samples/browse/python-api-examples

Enregistrer

Enregistrer

  • Aucune étiquette