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 emis

Exemplu 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

Articole similare

← Autentificare