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-Token

Beispiel-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

Verwandte Artikel

← Authentifizierung