Login

Aufzurufende URL (POST)

https://api.login.documedia.at/login_check

Zu übergebender Header

Content-Type: application/json X-FORCE-LOGIN: true

Zu übergebende Daten (JSON)

username: [User] password: [Passwort]

Ergebnis

Ein erfolgreicher Login liefert einen JWT-Token und einen entsprechenden Refresh-Token. Der JWT-Token wird für jeden weiteren Kontakt mit der Schnittstelle benötigt. Der Refresh-Token wird benötigt um einen neuen Token anzufordern (dies sollte nicht erforderlich sein, der Token ist eine Stunde lang gültig).

token: eyJ0eXAiwqiJKV1QiLCJhbGciO ... refresh_token: 20cd2170ef59651c5c ...

Zusätzlich wird im Header der Antwort ein Security Cookie gesendet. Das Cookie muss bei jedem weiteren Aufruf ebenfalls im Header mitgesendet werden.

Anfordern eines neuen Tokens

Ein neuer JWT-Token kann angefordert werden, um die Laufzeit der Session zu verlängern. Das Anfordern eines neuen Tokens sollte in der Regel nicht erforderlich sein, da der JWT-Token eine Stunde lang gültig ist.

Aufzurufende URL (POST)

https://api.login.documedia.at/token/refresh

Zu übergebender Header

Cookie: security=[Security Cookie]

Zu übergebende Form Daten

refresh_token: 20cd2170ef59651c5c ...

Ergebnis