POST/api/auth/reset-password

Stelt een nieuw wachtwoord in met het resettoken uit de resetmail.

Stuur `token` (uit de link van de resetmail) en het nieuwe `password` in de JSON-body. Hiervoor is geen aanmelding vereist. Het wachtwoord moet voldoen aan de minimumvereisten van Zentor App. Bij succes antwoordt de server met `{"ok":true}`; daarna meldt de gebruiker zich aan met het nieuwe wachtwoord. Een ongeldig, verlopen of al gebruikt token, en een wachtwoord dat niet aan de minimumvereisten voldoet, resulteren in 400 `VALIDATION_ERROR`. Een token wordt na succesvol gebruik verbruikt; start voor een volgende wijziging een nieuw proces via `POST /api/auth/forgot-password`. De endpoint is beperkt tot 10 aanvragen per 15 minuten per IP-adres. Stuur token en wachtwoord alleen in de requestbody via HTTPS, nooit als URL-parameter.

Overzicht

Aanroep: POST /api/auth/reset-password. Dit endpoint hoort bij de groep ‘Authenticatie’ van de API van Zentor App. Het is openbaar toegankelijk en vereist geen authenticatie. De aanroep is niet idempotent: elke geslaagde aanroep activeert de actie opnieuw. Verplichte parameters: token (body), password (body). Gedocumenteerde foutgevallen: 400 VALIDATION_ERROR. Het voorbeeldantwoord hieronder toont de opbouw van een geslaagd antwoord in JSON-formaat.

Auth & beveiliging

Geen authenticatie vereist

Idempotent: Nee

Parameters

token(body, string, vereist)— Resettoken uit de e-mail
password(body, string, vereist)— Nieuw wachtwoord

Voorbeeld-request

{"token":"<token uit de reset-e-mail>","password":"NieuwVeiligWachtwoord!"}

Voorbeeld-response

{"ok":true}

Foutcodes

400 VALIDATION_ERROR — Het token is ongeldig, verlopen of al gebruikt, of het wachtwoord voldoet niet aan de minimumvereisten.

Geverifieerd gedrag

Een ongeldig token levert 400 `VALIDATION_ERROR` op. Het succesgeval (200 `{"ok":true}`) wordt beschreven op basis van het gedocumenteerde verloop.

Authenticatie

Gerelateerde artikelen

← Authenticatie