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-tokenVoorbeeldversoek
{"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
POST /api/auth/loginMeld 'n gebruiker aan met e-posadres of gebruikersnaam en wagwoord en gee 'n toegangstoken (JWT) asook 'n refresh-token uit.POST /api/auth/forgot-passwordBegin die terugstel van 'n wagwoord: as 'n rekening met die opgegewe e-posadres bestaan, ontvang dit 'n e-pos met 'n skakel om terug te stel.POST /api/auth/reset-passwordStel 'n nuwe wagwoord in met die reset-token uit die terugstel-e-pos.POST /api/auth/sso/exchangeLaaste stap van 'n SSO-aanmelding (SAML/OIDC): ruil die eenmalige kode uit die herleiding vir 'n toegangstoken en 'n refresh-token.