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-Mail
password(body, string, erforderlich)— Neues Passwort

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

Verwandte Artikel

← Authentifizierung