POST/api/auth/reset-password
Isetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kabusha.
Thumela `token` (evela esixhumanisini se-imeyili yokusetha kabusha) ne`password` entsha kumzimba we-JSON. Ukungena akudingekile. Iphasiwedi kufanele ihambisane nezidingo eziphansi ze-Zentor App. Uma kuphumelele, iseva iphendula ngo`{"ok":true}`; emva kwalokho umsebenzisi angena nephasiwedi entsha. Ithokheni engasebenzi, ephelelwe isikhathi noma eyasivele isetshenzisiwe, kanye nephasiwedi engahambisani nezidingo eziphansi, kuholela ku-400 `VALIDATION_ERROR`. Ithokheni iqedwa ngemva kokusetshenziswa ngempumelelo; ukuze nishintshe futhi, qala inqubo entsha nge`POST /api/auth/forgot-password`. Isixhumi sikhawulelwe ezicelweni ezingu-10 ngemizuzu engu-15 ngekheli le-IP. Thumela ithokheni nephasiwedi kuphela emzimbeni wesicelo nge-HTTPS, neze njengamapharamitha e-URL.
Ukubuka konke
Ukubiza: POST /api/auth/reset-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: token (body), password (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: Cha
Amapharamitha
token(body, string, kuyadingeka)— Ithokheni ye-reset evela ku-imeyilipassword(body, string, kuyadingeka)— Iphasiwedi entshaIsibonelo se-request
{"token":"<Ithokheni evela ku-imeyili yokusetha kabusha>","password":"IphasiwediEntshaEphephile!"}Isibonelo se-response
{"ok":true}Amakhodi amaphutha
400 VALIDATION_ERROR — Ithokheni ayisebenzi, iphelelwe isikhathi noma yasivele isetshenzisiwe, noma iphasiwedi ayihambisani nezidingo eziphansi.Ukuziphatha okuhlolwe
Ithokheni engasebenzi inikeza i-400 `VALIDATION_ERROR`. Isimo sempumelelo (i-200 `{"ok":true}`) sichazwe ngokwenqubo ebhalwe phansi.
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/forgot-passwordIqala ukusetha kabusha iphasiwedi: uma i-akhawunti enekheli le-imeyili elinikeziwe ikhona, ithola i-imeyili enesixhumanisi sokusetha kabusha.POST /api/auth/sso/exchangeIsinyathelo sokugcina sokungena nge-SSO (SAML/OIDC): ishintshanisa ikhodi yokungenise eyodwa evela ekuqondisweni kabusha ngethokheni yokufinyelela nethokheni ye-refresh.