API-Keys für externe Systeme erstellen

API-Keys für externe Systeme erstellen

Mit API-Keys können externe Systeme — etwa dein Kassensystem, ein BI-Tool oder ein eigenes Skript — auf Shiftdesk-Daten zugreifen. Jeder Key bekommt genau definierte Scopes, sodass du den Zugriff so eng wie möglich halten kannst.

Neuen API-Key erstellen

1. Gehe zu Einstellungen → API-Keys.
2. Klicke auf Neuer API-Key.
3. Vergib einen Namen (z. B. "Kasse Filiale Köln").
4. Wähle die benötigten Scopes:

- employees:read — Mitarbeiterdaten lesen - shifts:read / shifts:write — Schichten lesen/schreiben - time-entries:read — Stempelungen lesen - absences:read — Abwesenheiten lesen

1. Klicke auf Erstellen.

Wichtig: Einmalige Anzeige

Der vollständige Key (sklive...) wird nur einmal angezeigt — direkt nach der Erstellung. Kopiere ihn sofort in einen sicheren Passwort-Manager. Danach siehst du im Dashboard nur noch die letzten 4 Zeichen zur Identifikation.

> Wenn du den Key verlierst, musst du einen neuen erstellen — Shiftdesk kann ihn nicht wiederherstellen.

Beispiel-Request

Die API-Base-URL lautet https://api.shiftdesk.app/v1. Authentifizierung erfolgt über den Authorization-Header:

bash
curl -H "Authorization: Bearer sklivexxxxxxxxxxxxxxxxxxxxxxxx" \
     -H "Content-Type: application/json" \
     https://api.shiftdesk.app/v1/employees

Rotation und Widerruf

Aus Sicherheitsgründen solltest du API-Keys mindestens jährlich rotieren:

1. Erstelle einen neuen Key mit identischen Scopes.
2. Hinterlege ihn im Zielsystem.
3. Prüfe, dass alles funktioniert.
4. Widerrufe den alten Key über das Mülleimer-Symbol in der Liste.

Widerrufene Keys werden sofort ungültig — laufende Requests schlagen mit 401 Unauthorized fehl.

Audit-Log

Jeder API-Zugriff wird mit Zeitstempel, IP und Endpoint im Audit-Log protokolliert. Du findest die Logs unter Einstellungen → Sicherheit → API-Aktivität.

Rate-Limits

Shiftdesk drosselt pro Key auf 120 Requests/Minute. Brauchst du mehr, melde dich beim Support.