Der Libraesva Email Archiver stellt eine Reihe von Application Programming Interfaces zur Verfügung.
Die APIs sind immer verfügbar, die Liste aller verfügbaren APIs finden Sie unter dem Pfad /api/v1/doc Ihres Archiver.
Z. B.: demo.archiver.esvacloud.com/api/v1/doc
Sie können direkt über die Dokumentationsseite mit den APIs interagieren, indem Sie sich über die Schaltfläche „Authorize“ oben rechts auf der Seite authentifizieren. Für diese Authentifizierung ist ein gültiges JWT erforderlich.
Um das JWT zu generieren, muss ein Login am Endpunkt „/api/{version}/login“ durchgeführt werden, der ein Token (das JWT) und ein Refresh-Token zurückgibt. Das Refresh-Token kann verwendet werden, um das JWT nach Ablauf neu zu generieren.
Um die Authentifizierung abzuschließen, müssen Sie das JWT zusammen mit dem Schlüsselwort „Bearer“ davor einfügen und dann auf „Authorize“ klicken. Jetzt sind Sie korrekt authentifiziert und können jeden der aufgeführten Endpunkte ausprobieren.
Beispiel:
Sobald das JWT-Token abläuft, können Sie mit dem „Refresh Token“, das von der API /login zurückgegeben wurde, ein neues generieren. Um ein neues JWT zu erzeugen, senden Sie das Refresh-Token als Parameter per POST an den Endpunkt „/api/{version}/refresh“.
Dies gibt ein neues gültiges JWT sowie ein neues Refresh-Token zurück, das für nachfolgende API-Aufrufe verwendet werden kann.