POST/api/auth/forgot-password
Iqala ukusetha kutsha iphasiwedi: nxa i-akhawunti elekheli le-imeyili elinikeziweyo ikhona, ithola i-imeyili elesixhumanisi sokusetha kutsha.
Thumelani ikheli le-imeyili le-akhawunti ensimini ethi `email`. Impendulo ethi `{"ok":true}` ihlala ifanayo ngabomu – loba i-akhawunti ikhona kumbe hatshi – ukuthi lesihlanganiso singakwazi ukuthola amakheli abhalisiweyo. Iphasiwedi entsha isethwa ngemva kwalokho ngethokheni evela ku-imeyili nge`POST /api/auth/reset-password`. Nxa insimu ethi `email` iswelekile kumbe ingaselutho, isihlanganiso siphendula ngo-400 `VALIDATION_ERROR`. Ukuvikela ukuhlukunyezwa, inani lezicelo ngekheli ngalinye le-IP likhawulelwe (429 `RATE_LIMIT_EXCEEDED`).
Isifinyezo
Ukubiza: POST /api/auth/forgot-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kanengi ngemininingwane efananayo kubuyisela umphumela ofananayo. Amapharamitha adingekayo: email (body). Izimo zamaphutha ezibhaliweyo: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.
Ukuqinisekisa ubuwena lokuvikeleka
Kakudingeki ukuqinisekisa ubuwena
I-idempotent: Yebo
Amapharamitha
email(body, string, kuyadingeka)— Ikheli le-imeyili le-akhawuntiIsibonelo sesicelo (request)
{"email":"user@example.com"}Isibonelo sempendulo (response)
{"ok":true}Amakhodi amaphutha
400 VALIDATION_ERROR — Insimu ethi `email` iswelekile kumbe ingaselutho.Ukuziphatha okuhlolwe
Impendulo yi-200 `{"ok":true}`, kungelandaba ukuthi i-akhawunti ikhona kumbe hatshi; insimu ye-imeyili eswelekileyo inikeza i-400 `VALIDATION_ERROR`.
Ukuqinisekiswa
POST /api/auth/loginIngenisa umsebenzisi ngekheli le-imeyili kumbe ibizo lokusebenzisa lephasiwedi njalo ikhuphe ithokheni yokufinyelela (JWT) kanye lerefresh token.POST /api/auth/refreshItshintshanisa i-refresh-token esebenzayo ngombandela omutsha wethokheni yokufinyelela lerefresh token.POST /api/auth/reset-passwordIsetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kutsha.POST /api/auth/sso/exchangeIsinyathelo sokucina sokungena nge-SSO (SAML/OIDC): itshintshanisa ikhodi yakanye evela ekuqondisweni kutsha ngethokheni yokufinyelela lerefresh token.