POST/api/auth/refresh

Ruil 'n geldige refresh-token vir 'n nuwe paar toegangstoken en refresh-token.

Stuur die onlangs ontvangde `refreshToken` in die JSON-liggaam. Die antwoord bevat 'n nuwe `token` en 'n nuwe `refreshToken`. Elke refresh-token is net een keer gebruikbaar en standaard sewe dae geldig; stoor na elke oproep die nuwe token en gooi die ou een weg. 'n Ontbrekende, ongeldige, verlopde of reeds gebruikte refresh-token lei tot 400 `VALIDATION_ERROR`. Die gebruiker moet dan weer via `POST /api/auth/login` aanmeld. Omdat 'n refresh-token met gebruik verbruik word, behoort 'n kliënt gelyktydige vernuwings te vermy.

Oorsig

Oproep: POST /api/auth/refresh. Hierdie eindpunt behoort tot die groep “Verifikasie” van die Zentor App-API. Dit is publiek toeganklik en vereis geen verifikasie nie. Die oproep is nie idempotent nie: elke suksesvolle oproep aktiveer die aksie opnuut. Verpligte parameters: refreshToken (body). Gedokumenteerde foutgevalle: 400 VALIDATION_ERROR. Die voorbeeldrespons hieronder toon die struktuur van ’n suksesvolle respons in JSON-formaat.

Verifikasie en sekuriteit

Geen verifikasie vereis nie

Idempotent: Nee

Parameters

refreshToken(body, string, vereis)— Onlangs uitgereikte refresh-token

Voorbeeldversoek

{"refreshToken":"<Refresh-Token uit /login>"}

Voorbeeldrespons

{"ok":true,"token":"<nuwe JWT>","refreshToken":"<nuwe Refresh-Token>"}

Foutkodes

400 VALIDATION_ERROR — Refresh-token ontbreek, is ongeldig, verlope of is reeds gebruik.

Gekontroleerde gedrag

'n Geldige refresh-token lewer 'n nuwe tokenpaar; 'n ongeldige token lewer 400 `VALIDATION_ERROR`.

Verifikasie

Verwante artikels

← Verifikasie