POST/api/auth/reset-password
Setează o parolă nouă folosind tokenul de resetare din e-mailul de resetare.
Trimiteți `token` (din linkul e-mailului de resetare) și noua `password` în corpul JSON. Nu este necesară autentificare pentru aceasta. Parola trebuie să respecte cerințele minime ale Zentor App. În caz de succes, serverul răspunde cu `{"ok":true}`; apoi utilizatorul se autentifică cu noua parolă. Un token invalid, expirat sau deja utilizat, precum și o parolă care nu respectă cerințele minime, au ca rezultat 400 `VALIDATION_ERROR`. Un token este consumat după o utilizare reușită; pentru o altă modificare, inițiați un nou proces prin `POST /api/auth/forgot-password`. Endpointul este limitat la 10 cereri la 15 minute per adresă IP. Transmiteți tokenul și parola doar în corpul cererii, prin HTTPS, niciodată ca parametru URL.
Prezentare generală
Apel: POST /api/auth/reset-password. 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: token (body), password (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
token(body, string, obligatoriu)— Token de resetare din e-mailpassword(body, string, obligatoriu)— Parolă nouăExemplu de cerere
{"token":"<token din e-mailul de resetare>","password":"NouaParolaSigura!"}Exemplu de răspuns
{"ok":true}Coduri de eroare
400 VALIDATION_ERROR — Tokenul este invalid, expirat sau deja utilizat, sau parola nu respectă cerințele minime.Comportament verificat
Un token invalid returnează 400 `VALIDATION_ERROR`. Cazul de succes (200 `{"ok":true}`) este descris pe baza fluxului documentat.
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/refreshSchimbă un refresh token valid pentru o nouă pereche de token de acces și 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/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.