POST/api/auth/refresh
Zamenja veljaven žeton za obnovitev za nov par dostopnega žetona in žetona za obnovitev.
Pošljite nazadnje prejeti `refreshToken` v telesu JSON. Odgovor vsebuje nov `token` in nov `refreshToken`. Vsak žeton za obnovitev je uporaben samo enkrat in privzeto velja sedem dni; po vsakem klicu shranite nov žeton in zavrzite starega. Manjkajoč, neveljaven, potekel ali že uporabljen žeton za obnovitev povzroči 400 `VALIDATION_ERROR`. Uporabnik se mora takrat ponovno prijaviti prek `POST /api/auth/login`. Ker je žeton za obnovitev porabljen z uporabo, naj odjemalec preprečuje vzporedne obnovitve.
Pregled
Klic: POST /api/auth/refresh. Ta endpoint spada v skupino »Avtentikacija« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: refreshToken (body). Dokumentirani primeri napak: 400 VALIDATION_ERROR. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.
Avtentikacija in zaščita
Avtentikacija ni potrebna
Idempotentno: Ne
Parametri
refreshToken(body, string, obvezno)— Nazadnje izdan žeton za obnovitevPrimer zahteve
{"refreshToken":"<žeton za osvežitev iz /login>"}Primer odgovora
{"ok":true,"token":"<nov JWT>","refreshToken":"<nov žeton za osvežitev>"}Kode napak
400 VALIDATION_ERROR — Žeton za obnovitev manjka, je neveljaven, je potekel ali je že bil uporabljen.Preverjeno vedenje
Veljaven žeton za obnovitev vrne nov par žetonov; neveljaven žeton vrne 400 `VALIDATION_ERROR`.
Avtentikacija
POST /api/auth/loginPrijavi uporabnika z e-poštnim naslovom ali uporabniškim imenom in geslom ter izda dostopni žeton (JWT) in žeton za obnovitev (refresh token).POST /api/auth/forgot-passwordSproži ponastavitev gesla: če obstaja račun z navedenim e-poštnim naslovom, prejme e-pošto s povezavo za ponastavitev.POST /api/auth/reset-passwordNastavi novo geslo z žetonom za ponastavitev iz e-pošte.POST /api/auth/sso/exchangeZadnji korak prijave SSO (SAML/OIDC): zamenja enkratno kodo iz preusmeritve za dostopni žeton in žeton za obnovitev.