Um auf die API zugreifen zu können muss man sich erst authentifizieren. Der Ablauf ist folgender:
- Um die API zu vewenden wird ein Alias benötigt, über den ermittelt werden kann, wer auf die API zugreift. Das Alias erhält man im AMPAREX Client unter Filialverwaltung → Servicezugangsdaten → Resource spezifische URL
- Alias kopieren
- Login Bereich in der Swagger-UI aufklappen und auf Try-Out klicken:
- Alle erforderlichen Parameter eintragen. Benutzername und Passwort entsprechen den Servicezugangsdaten des Alias:
- Auf Execute klicken → Die Anfrage wird an den Server geschickt
- Als Antwort erscheint im Feld "Server Response" nun das Login Token (Bearer Token):
- Markierten Bereich kopieren. Alles zwischen den Anführungszeichen.
- Nun im Kopf von Swagger-UI auf Authorize klicken:
- Es erscheint folgender Dialog:
In dem Dialog muss in dem Feld "Value" das Login Token (Bearer Token) eingetragen werden. Dazu "Bearer" eintippen plus Leertaste. Danach das zuvor erhaltene Login-Token einfügen und auf Autorize klicken. - Das Login Token ist nun gesetzt und wird für alle folgenden HTTP Aufrufe im Header mitgeschickt.