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 : http://pkg.blue-mind.net/mvn/net/bluemind/net.bluemind.bm-api/ en sélectionnant la version correspondante à votre installation.

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 et une présentation rapide sur la page Client Python

Enregistrer

Enregistrer