POST/api/auth/reset-password
Setzt ein neues Passwort mit dem Reset-Token aus der E-Mail zum Zurücksetzen.
Senden Sie `token` (aus dem Link der Reset-E-Mail) und das neue `password` im JSON-Body. Eine Anmeldung ist dafür nicht erforderlich. Das Passwort muss die Mindestanforderungen von Zentor App erfüllen. Bei Erfolg antwortet der Server mit `{"ok":true}`; danach meldet sich der Benutzer mit dem neuen Passwort an. Ein ungültiges, abgelaufenes oder bereits verwendetes Token sowie ein Passwort, das die Mindestanforderungen nicht erfüllt, führen zu 400 `VALIDATION_ERROR`. Ein Token ist nach erfolgreicher Verwendung verbraucht; für einen weiteren Wechsel starten Sie über `POST /api/auth/forgot-password` einen neuen Vorgang. Der Endpunkt ist auf 10 Anfragen je 15 Minuten pro IP-Adresse begrenzt. Übertragen Sie Token und Passwort nur im Request-Body über HTTPS, niemals als URL-Parameter.
Überblick
Aufruf: POST /api/auth/reset-password. 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: token (Body), password (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
token(body, string, erforderlich)— Reset-Token aus der E-Mailpassword(body, string, erforderlich)— Neues PasswortBeispiel-Request
{"token":"<Token aus Reset-Mail>","password":"NeuesSicheresPasswort!"}Beispiel-Response
{"ok":true}Fehlercodes
400 VALIDATION_ERROR — Das Token ist ungültig, abgelaufen oder bereits verwendet, oder das Passwort erfüllt die Mindestanforderungen nicht.Geprüftes Verhalten
Ein ungültiges Token liefert 400 `VALIDATION_ERROR`. Der Erfolgsfall (200 `{"ok":true}`) ist anhand des dokumentierten Ablaufs beschrieben.
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/refreshTauscht ein gültiges Refresh-Token gegen ein neues Paar aus Zugangstoken und Refresh-Token.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/sso/exchangeLetzter Schritt einer SSO-Anmeldung (SAML/OIDC): tauscht den Einmalcode aus der Weiterleitung gegen ein Zugangstoken und ein Refresh-Token.