POST/api/auth/refresh
Tauscht ein gültiges Refresh-Token gegen ein neues Paar aus Zugangstoken und Refresh-Token.
Senden Sie das zuletzt erhaltene `refreshToken` im JSON-Body. Die Antwort enthält ein neues `token` und ein neues `refreshToken`. Jedes Refresh-Token ist nur einmal verwendbar und standardmäßig sieben Tage gültig; speichern Sie nach jedem Aufruf das neue Token und verwerfen Sie das alte. Ein fehlendes, ungültiges, abgelaufenes oder bereits verwendetes Refresh-Token führt zu 400 `VALIDATION_ERROR`. Der Benutzer muss sich dann erneut über `POST /api/auth/login` anmelden. Da ein Refresh-Token mit der Verwendung verbraucht ist, sollte ein Client parallele Erneuerungen vermeiden.
Überblick
Aufruf: POST /api/auth/refresh. Der Endpunkt gehört zur Gruppe „Authentifizierung“ der API von Zentor App. Er ist öffentlich erreichbar und benötigt keine Authentifizierung. Der Aufruf ist nicht idempotent: Jeder erfolgreiche Aufruf löst die Aktion erneut aus. Pflichtparameter: refreshToken (Body). Dokumentierte Fehlerfälle: 400 VALIDATION_ERROR. Die Beispielantwort unten zeigt den Aufbau einer erfolgreichen Antwort im JSON-Format.
Auth & Absicherung
Keine Authentifizierung erforderlich
Idempotent: Nein
Parameter
refreshToken(body, string, erforderlich)— Zuletzt ausgestelltes Refresh-TokenBeispiel-Request
{"refreshToken":"<Refresh-Token aus /login>"}Beispiel-Response
{"ok":true,"token":"<neues JWT>","refreshToken":"<neues Refresh-Token>"}Fehlercodes
400 VALIDATION_ERROR — Refresh-Token fehlt, ist ungültig, abgelaufen oder wurde bereits verwendet.Geprüftes Verhalten
Ein gültiges Refresh-Token liefert ein neues Token-Paar; ein ungültiges Token liefert 400 `VALIDATION_ERROR`.
Authentifizierung
POST /api/auth/loginMeldet einen Benutzer mit E-Mail-Adresse oder Benutzername und Passwort an und gibt ein Zugangstoken (JWT) sowie ein Refresh-Token aus.POST /api/auth/forgot-passwordStartet das Zurücksetzen eines Passworts: Existiert ein Konto mit der angegebenen E-Mail-Adresse, erhält es eine E-Mail mit einem Link zum Zurücksetzen.POST /api/auth/reset-passwordSetzt ein neues Passwort mit dem Reset-Token aus der E-Mail zum Zurücksetzen.POST /api/auth/sso/exchangeLetzter Schritt einer SSO-Anmeldung (SAML/OIDC): tauscht den Einmalcode aus der Weiterleitung gegen ein Zugangstoken und ein Refresh-Token.