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 token

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

Gerelateerde artikelen

← Authenticatie