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-mailpassword(body, string, vereist)— Nieuw wachtwoordVoorbeeld-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
POST /api/auth/loginMeldt een gebruiker aan met e-mailadres of gebruikersnaam en wachtwoord en geeft een toegangstoken (JWT) en een refresh token uit.POST /api/auth/refreshWisselt een geldig refresh token in voor een nieuw paar toegangstoken en refresh token.POST /api/auth/forgot-passwordStart het resetten van een wachtwoord: bestaat er een account met het opgegeven e-mailadres, dan ontvangt dit een e-mail met een resetlink.POST /api/auth/sso/exchangeLaatste stap van een SSO-aanmelding (SAML/OIDC): wisselt de eenmalige code uit de doorverwijzing in voor een toegangstoken en een refresh token.