POST/api/auth/forgot-password
Iniț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.
Trimiteți adresa de e-mail a contului în câmpul `email`. Răspunsul `{"ok":true}` este în mod deliberat mereu identic – indiferent dacă există un cont – astfel încât acest endpoint să nu permită determinarea adreselor înregistrate. Noua parolă se setează apoi cu tokenul din e-mail prin `POST /api/auth/reset-password`. Dacă câmpul `email` lipsește sau este gol, endpointul răspunde cu 400 `VALIDATION_ERROR`. Pentru a preveni abuzurile, numărul de cereri per adresă IP este limitat (429 `RATE_LIMIT_EXCEEDED`).
Prezentare generală
Apel: POST /api/auth/forgot-password. Acest endpoint aparține grupului „Autentificare” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul este idempotent: apelurile repetate cu aceleași date returnează același rezultat. Parametri obligatorii: email (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: Da
Parametri
email(body, string, obligatoriu)— Adresa de e-mail a contuluiExemplu de cerere
{"email":"user@example.com"}Exemplu de răspuns
{"ok":true}Coduri de eroare
400 VALIDATION_ERROR — Câmpul `email` lipsește sau este gol.Comportament verificat
Răspunsul este 200 `{"ok":true}`, indiferent dacă există contul; un câmp de e-mail lipsă 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/refreshSchimbă un refresh token valid pentru o nouă pereche de token de acces și refresh token.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.