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čunaPrimer 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
POST /api/auth/loginPrijavi uporabnika z e-poštnim naslovom ali uporabniškim imenom in geslom ter izda dostopni žeton (JWT) in žeton za obnovitev (refresh token).POST /api/auth/refreshZamenja veljaven žeton za obnovitev za nov par dostopnega žetona in žetona za obnovitev.POST /api/auth/reset-passwordNastavi novo geslo z žetonom za ponastavitev iz e-pošte.POST /api/auth/sso/exchangeZadnji korak prijave SSO (SAML/OIDC): zamenja enkratno kodo iz preusmeritve za dostopni žeton in žeton za obnovitev.