Pré-requis

Description

L'archive contient :

Utilisation

Exécution du serveur

Pour exécuter le serveur, lancer l'exécutable correspondant à votre OS :

Pour s'assurer que le serveur s'est bien démarré, vérifier les pages suivantes :

Utilisation de la RAML Console

Les fichiers RAML de documentation de l'API Vitam sont chargés dans la RAML Console en les renseignant dans le champ "INITIALIZE FROM THE URL OF A RAML FILE" l'un des chemins suivants :

Les fichiers RAML de documentation de l'API Vitam sont dans le dossier console/raml. Toute modification d'un de ces fichiers nécessite de redémarrage du serveur.

Utilisation de la fonctionnalité TRY-IT de la RAML Console

Une fonctionalité TRY-IT permettant de tester les API est fournie par la RAML Console. Pour des raisons de manque de stabilité de la fonctionnalité offerte par cet outil externe au Programme Vitam, elle est désactivée par défaut.

Elle reste accessible sur l'URL http://localhost:8082/doc/api-console-try-it.html

Pour utiliser la fonctionnalité TRY-IT de la RAML Console, il est préférable d'utiliser les chemins suivants :

La fonctionnalité TRY-IT de la RAML Console utilise par défaut les bouchons fournis par le serveur. Pour utiliser un autre serveur, il faut modifier la valeur de l'attribut baseUri des fichiers RAML utilisés.

Utilisation des bouchons de l'API VITAM

Les bouchons sont déployés sur l'URL http://localhost:8082/external/v1

Documentation html de l'API VITAM

La documentation html de l'API VITAM se trouve dans le dossier html et peut être consultée directement en se rendant à l'adresse http://localhost:8082/doc/html

Elle inclut les Javadoc des modules suivants :

Ainsi que ce présent fichier et la licence globale du logiciel Vitam.

Configuration

Changer le port HTTP du serveur

La valeur du port HTTP sur lequel s'exécute le serveur est 8082 par défaut.

Pour modifier cette valeur, il faut l'ajouter en argument de l'exécutable :

Configuration des logs

Les logs utilisent la bibliothèque LOGBack (http://logback.qos.ch/).

Le fichier de configuration des logs est : config/logback.xml. Toute modification de ce fichier nécessite le redémarrage du serveur.

Exemples de codes clients

Le répertoire « samples » contient des exemples de codes Java (avec un modèle de pom.xml) pour illustrer l'usage des API Java proposées :

Il propose également des exemples de commandes Curl pour utiliser les API :