POST/api/auth/forgot-password
Iqala ukusetha kabusha iphasiwedi: uma i-akhawunti enekheli le-imeyili elinikeziwe ikhona, ithola i-imeyili enesixhumanisi sokusetha kabusha.
Thumela ikheli le-imeyili le-akhawunti ensimini ethi `email`. Impendulo ethi `{"ok":true}` ihlala ifanayo ngamabomu – kungakhathaliseki ukuthi i-akhawunti ikhona noma cha – ukuze lesi sixhumi singavunyelwe kuthole amakheli abhalisiwe. Iphasiwedi entsha isethwa ngemva kwalokho ngethokheni evela ku-imeyili nge`POST /api/auth/reset-password`. Uma insimu ethi `email` ishoda noma ingenalutho, isixhumi siphendula ngo-400 `VALIDATION_ERROR`. Ukuvikela ukuhlukunyezwa, inani lezicelo ngekheli ngalinye le-IP likhawulelwe (429 `RATE_LIMIT_EXCEEDED`).
Ukubuka konke
Ukubiza: POST /api/auth/forgot-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kaningi ngemininingwane efanayo kubuyisa umphumela ofanayo. Amapharamitha ayimpoqo: email (body). Izimo zamaphutha ezibhaliwe: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubunikazi nokuvikeleka
Akudingeki ukuqinisekisa ubunikazi
I-idempotent: Yebo
Amapharamitha
email(body, string, kuyadingeka)— Ikheli le-imeyili le-akhawuntiIsibonelo se-request
{"email":"user@example.com"}Isibonelo se-response
{"ok":true}Amakhodi amaphutha
400 VALIDATION_ERROR — Insimu ethi `email` ishoda noma ingenalutho.Ukuziphatha okuhlolwe
Impendulo iyi-200 `{"ok":true}`, kungakhathaliseki ukuthi i-akhawunti ikhona noma cha; insimu ye-imeyili eshodayo inikeza i-400 `VALIDATION_ERROR`.
Ukuqinisekiswa
POST /api/auth/loginIngena umsebenzisi ngekheli le-imeyili noma igama lokusebenzisa nephasiwedi futhi ikhiphe ithokheni yokufinyelela (JWT) kanye nethokheni ye-refresh.POST /api/auth/refreshShintshanisa i-refresh-token esebenzayo ngombandela omusha wethokheni yokufinyelela nethokheni ye-refresh.POST /api/auth/reset-passwordIsetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kabusha.POST /api/auth/sso/exchangeIsinyathelo sokugcina sokungena nge-SSO (SAML/OIDC): ishintshanisa ikhodi yokungenise eyodwa evela ekuqondisweni kabusha ngethokheni yokufinyelela nethokheni ye-refresh.