API-Authentifizierung

Create Token

API Swagger description public

https://[deineInstanz].empplan.io/api-docs

Demo Container API Swagger description public

https://demo.empplan.io/api-docs

🔐 API-Token / Authentifizierung

• API-Token kann im Benutzerprofil erstellt werden.
• Der API-Tab ist nur im eigenen Benutzerprofil sichtbar
  (Userliste → eigenes Profil)
  und nur, wenn der Benutzer über Admin-Rechte verfügt.
• Um ein neues Token zu erzeugen (das alte Token wird dabei ungültig), auf den Reload-/Refresh-Button klicken.
• Der erste Button rechts neben dem Eingabefeld kopiert das Token in die Zwischenablage.
• /#!/useredit

Screenshot generate Token

🔑 Tokens Refresh

• Die Gültigkeitsdauer eines Tokens beträgt 2 Monate.
• Ein Token kann mit einem gültigen Bearer-Token erneuert werden.
  Dabei wird das alte Token automatisch ungültig.
• Endpoint zur Erzeugung eines neuen Tokens mit gültigem Bearer-Token:
  /api/bearer/generatetoken

Curl Example call:

TOKEN=""
curl -H 'Accept: application/json' -H "Authorization: Bearer ${TOKEN}" http://localhost:3004/api/beaer/generatetoken

Response:

{
token:"TOKEN",
user:userobject
}

Test route curl example:

To test a new token you can use this curl statement:

TOKEN=""
curl -H 'Accept: application/json' -H "Authorization: Bearer ${TOKEN}" http://localhost:3004/api/sellout/all