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 contului

Exemplu 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

Articole similare

← Autentificare