# Esanté Connect – Interface REST

****Esanté Connect – Interface REST**** est une application autonome à installer sur un serveur exploité par le client.

Le service exposé est une API REST en JSON.

<span style="white-space: pre-wrap;">Les Fonctions exposées permettent l’accès au DMP à partir d’une application (web ou client lourd) en </span>****authentification indirecte****<span style="white-space: pre-wrap;"> via un certificat logiciel d’établissement.</span>

#### Installation sur un poste dev

La procédure suivante décrit les étapes pour la version Linux du connecteur, une version darwin est aussi disponible sur l'espace Icanopée

- <span style="white-space: pre-wrap;">Sur </span>[https://clients.icanopee.net/produit/437/builds/dist](https://clients.icanopee.net/produit/437/builds/dist)
- - <span style="white-space: pre-wrap;">Récupérer sur le zip </span>****dmpconnect-es-rest-mss-insi-&lt;version&gt;-Linux.zip****
    - <span style="white-space: pre-wrap;">Récupérer le zip </span>****dmpconnect-es-rest\_sdk-mss-insi-&lt;version&gt;.zip****
- <span style="white-space: pre-wrap;">Sur </span>[https://clients.icanopee.net/produit/437/configuration](https://clients.icanopee.net/produit/437/configuration)
    - <span style="white-space: pre-wrap;">Récupérer le fichier </span>****dcparameters.esrest.v2.dev.reconnect\_esrest.dat****

1. <span style="white-space: pre-wrap;">Copier le fichier </span>****dcparameters.esrest.v2.dev.reconnect\_esrest.dat****<span style="white-space: pre-wrap;"> dans le dossier </span>****DmpConnect-ES-REST-MSS-INSI-1.10.0-Linux**** <span style="white-space: pre-wrap;">en le renommant </span>****dcparameters.dat****
2. Lancer l'exécutable ****dmpconnect-es-rest.**** À ce stade, le serveur devrait être lancé.
3. <span style="white-space: pre-wrap;">Pour tester rapidement, ouvrir le fichier </span>****sdk/exemples\_js/examples.html****<span style="white-space: pre-wrap;"> dans un navigateur et lancer les exemples en cliquant sur les liens. Les requêtes/réponses effectuées seront visible dans la console du navigateur</span>
4. <span style="white-space: pre-wrap;">Il est possible de modifier certains paramètres du serveur en éditant le fichier </span>****dmpconnect-esrest.xml****<span style="white-space: pre-wrap;"> (port d'écoute, niveau de logs etc...). L'exécutable</span> ****dmpconnect-es-rest****<span style="white-space: pre-wrap;"> doit être relancé après chaque modification.</span>

<span style="white-space: pre-wrap;">Par défaut, l'adresse pour effectuer des requêtes au connecteur est </span>****https://0.0.0.0:9979****  
Il est tout à fait possible de tester de construire les requêtes vers le connecteur avec un client HTTP (ici Postman)

[![image(9).png](https://ambroise.reconnect.fr/uploads/images/gallery/2025-06/scaled-1680-/image9.png)](https://ambroise.reconnect.fr/uploads/images/gallery/2025-06/image9.png)

<span style="white-space: pre-wrap;">La documentation plus détaillée est visible sous </span>****sdk/doc.****

#### Installation sur nos serveurs

<span style="white-space: pre-wrap;">Le dossier du connecteur se trouve sous </span>****~/rest\_connector/****

Un service systemd (****dmp\_connector****<span style="white-space: pre-wrap;">) est en cours de création actuellement (il nécessitera d'être dans un premier temps activé avec </span>****sudo systemctl enable dmp\_connector.service****).  
  
<span style="white-space: pre-wrap;">Ensuite il sera possible de gérer ce service grâce aux différentes commandes </span>****stop****<span style="white-space: pre-wrap;">, </span>****restart****<span style="white-space: pre-wrap;">, </span>****status****<span style="white-space: pre-wrap;">, ou encore consulter les logs via </span>****journalctl****.