Le Libraesva Email Archiver expose un ensemble d'Application Programming Interface.
Les API sont toujours disponibles, la liste de toutes les API disponibles se trouve au chemin /api/v1/doc de votre Archiver.
Ex. : demo.archiver.esvacloud.com/api/v1/doc
Vous pouvez interagir avec les API directement depuis la page de documentation en vous authentifiant grâce au bouton "Authorize" en haut à droite de la page, cette authentification nécessitera un JWT valide.
Pour générer le JWT, une connexion doit être effectuée sur le endpoint "/api/{version}/login", qui renverra un token (le JWT) et un refresh token ; ce refresh token peut être utilisé pour régénérer le JWT après son expiration.
Pour finaliser l'authentification, vous devez coller le JWT en faisant précéder celui-ci du mot-clé "Bearer", puis cliquer sur "Authorize" ; vous êtes désormais correctement authentifié et pouvez tester n'importe quel des endpoints listés.
Exemple :
Une fois le token JWT expiré, vous pouvez en générer un nouveau en utilisant le "Refresh Token" renvoyé par l'appel API /login ; pour générer un nouveau JWT, envoyez (POST) le refresh token en tant que paramètre au endpoint "/api/{version}/refresh" .
Cela renverra un nouveau JWT valide et un nouveau Refresh Token à utiliser pour les appels API suivants.