Um auf die API zugreifen zu können muss man sich erst authentifizieren. Der Ablauf ist folgender:

  1. 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

  2. Alias kopieren
  3. Login Bereich in der Swagger-UI aufklappen und auf Try-Out klicken:
  4. Alle erforderlichen Parameter eintragen. Benutzername und Passwort entsprechen den Servicezugangsdaten des Alias:
  5. Auf Execute klicken → Die Anfrage wird an den Server geschickt
  6. Als Antwort erscheint im Feld "Server Response" nun das Login Token (Bearer Token):
  7. Markierten Bereich kopieren. Alles zwischen den Anführungszeichen.
  8. Nun im Kopf von Swagger-UI auf Authorize klicken:
  9. 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.
  10. Das Login Token ist nun gesetzt und wird für alle folgenden HTTP Aufrufe im Header mitgeschickt.