POST/api/auth/forgot-password

Sproži ponastavitev gesla: če obstaja račun z navedenim e-poštnim naslovom, prejme e-pošto s povezavo za ponastavitev.

Pošljite e-poštni naslov računa v polju `email`. Odgovor `{"ok":true}` je namenoma vedno enak – ne glede na to, ali račun obstaja –, da prek te končne točke ni mogoče ugotoviti, kateri naslovi so registrirani. Novo geslo se nato nastavi z žetonom iz e-pošte prek `POST /api/auth/reset-password`. Če polje `email` manjka ali je prazno, končna točka odgovori s 400 `VALIDATION_ERROR`. Za zaščito pred zlorabo je število zahtev na IP-naslov omejeno (429 `RATE_LIMIT_EXCEEDED`).

Pregled

Klic: POST /api/auth/forgot-password. Ta endpoint spada v skupino »Avtentikacija« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic je idempotenten: ponovljeni klici z enakimi podatki vrnejo enak rezultat. Obvezni parametri: email (body). Dokumentirani primeri napak: 400 VALIDATION_ERROR. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.

Avtentikacija in zaščita

Avtentikacija ni potrebna

Idempotentno: Da

Parametri

email(body, string, obvezno)— E-poštni naslov računa

Primer zahteve

{"email":"user@example.com"}

Primer odgovora

{"ok":true}

Kode napak

400 VALIDATION_ERROR — Polje `email` manjka ali je prazno.

Preverjeno vedenje

Odgovor je 200 `{"ok":true}`, ne glede na to, ali račun obstaja; manjkajoče polje e-pošte vrne 400 `VALIDATION_ERROR`.

Avtentikacija

Sorodni članki

← Avtentikacija