POST/api/auth/refresh
Schimbă un refresh token valid pentru o nouă pereche de token de acces și refresh token.
Trimiteți în corpul JSON cel mai recent `refreshToken` primit. Răspunsul conține un nou `token` și un nou `refreshToken`. Fiecare refresh token poate fi utilizat o singură dată și este valabil implicit șapte zile; salvați noul token după fiecare apel și eliminați-l pe cel vechi. Un refresh token lipsă, invalid, expirat sau deja utilizat are ca rezultat 400 `VALIDATION_ERROR`. Utilizatorul trebuie să se autentifice din nou prin `POST /api/auth/login`. Deoarece un refresh token este consumat la utilizare, un client ar trebui să evite reînnoirile paralele.
Prezentare generală
Apel: POST /api/auth/refresh. Acest endpoint aparține grupului „Autentificare” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: refreshToken (body). Cazuri de eroare documentate: 400 VALIDATION_ERROR. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.
Autentificare și securitate
Nu este necesară autentificarea
Idempotent: Nu
Parametri
refreshToken(body, string, obligatoriu)— Cel mai recent refresh token emisExemplu de cerere
{"refreshToken":"<Refresh token din /login>"}Exemplu de răspuns
{"ok":true,"token":"<JWT nou>","refreshToken":"<Refresh token nou>"}Coduri de eroare
400 VALIDATION_ERROR — Refresh tokenul lipsește, este invalid, expirat sau a fost deja utilizat.Comportament verificat
Un refresh token valid returnează o nouă pereche de tokenuri; un token invalid returnează 400 `VALIDATION_ERROR`.
Autentificare
POST /api/auth/loginAutentifică un utilizator cu adresa de e-mail sau numele de utilizator și parola, și emite un token de acces (JWT) și un refresh token.POST /api/auth/forgot-passwordInițiază resetarea unei parole: dacă există un cont cu adresa de e-mail indicată, acesta primește un e-mail cu un link de resetare.POST /api/auth/reset-passwordSetează o parolă nouă folosind tokenul de resetare din e-mailul de resetare.POST /api/auth/sso/exchangeUltimul pas al unei autentificări SSO (SAML/OIDC): schimbă codul de unică folosință din redirecționare pentru un token de acces și un refresh token.