POST/api/auth/refresh
Wisselt een geldig refresh token in voor een nieuw paar toegangstoken en refresh token.
Stuur de meest recent ontvangen `refreshToken` in de JSON-body. Het antwoord bevat een nieuw `token` en een nieuw `refreshToken`. Elk refresh token is maar één keer bruikbaar en standaard zeven dagen geldig; bewaar na elke aanroep het nieuwe token en gooi het oude weg. Een ontbrekend, ongeldig, verlopen of al gebruikt refresh token resulteert in 400 `VALIDATION_ERROR`. De gebruiker moet dan opnieuw aanmelden via `POST /api/auth/login`. Omdat een refresh token bij gebruik wordt verbruikt, moet een client parallelle verversingen vermijden.
Overzicht
Aanroep: POST /api/auth/refresh. 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: refreshToken (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
refreshToken(body, string, vereist)— Meest recent uitgegeven refresh tokenVoorbeeld-request
{"refreshToken":"<refresh-token uit /login>"}Voorbeeld-response
{"ok":true,"token":"<nieuwe JWT>","refreshToken":"<nieuw refresh-token>"}Foutcodes
400 VALIDATION_ERROR — Het refresh token ontbreekt, is ongeldig, verlopen of al gebruikt.Geverifieerd gedrag
Een geldig refresh token levert een nieuw tokenpaar op; een ongeldig token levert 400 `VALIDATION_ERROR` op.
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/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/reset-passwordStelt een nieuw wachtwoord in met het resettoken uit de resetmail.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.