POST/api/auth/reset-password
Isetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kutsha.
Thumelani `token` (esuka kusixhumanisi se-imeyili yokusetha kutsha) kanye le`password` entsha emzimbeni we-JSON. Ukungena kakudingakalanga. Iphasiwedi kumele ihambisane lezidingo ezincane zeZentor App. Nxa kuphumelele, iseva iphendula nge`{"ok":true}`; ngemva kwalokho umsebenzisi angena lephasiwedi entsha. Ithokheni engasebenziyo, ephelelwe isikhathi kumbe eyasele isetshenzisiwe, kanye lephasiwedi engahambisaniyo lezidingo ezincane, kuholela ku-400 `VALIDATION_ERROR`. Ithokheni iqedwa ngemva kokusetshenziswa ngempumelelo; ukuthi liphinde lintshintshe, qalisani inqubo entsha nge`POST /api/auth/forgot-password`. Isihlanganiso sikhawulelwe ezicelweni ezingu-10 ngemizuzu engu-15 ngekheli le-IP. Thumelani ithokheni lephasiwedi kuphela emzimbeni wesicelo nge-HTTPS, lanini njengamapharamitha e-URL.
Isifinyezo
Ukubiza: POST /api/auth/reset-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: token (body), password (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: Hatshi
Amapharamitha
token(body, string, kuyadingeka)— Ithokheni ye-reset evela ku-imeyilipassword(body, string, kuyadingeka)— Iphasiwedi entshaIsibonelo sesicelo (request)
{"token":"<Ithokheni evela ku-imeyili yokusetha kabusha>","password":"IphasiwediEntshaEvikelekileyo!"}Isibonelo sempendulo (response)
{"ok":true}Amakhodi amaphutha
400 VALIDATION_ERROR — Ithokheni kayisebenzi, iphelelwe isikhathi kumbe eyasele isetshenzisiwe, kumbe iphasiwedi kayihambisani lezidingo ezincane.Ukuziphatha okuhlolwe
Ithokheni engasebenziyo inikeza i-400 `VALIDATION_ERROR`. Isimo sempumelelo (i-200 `{"ok":true}`) sichazwe ngokwenqubo ebhaliweyo.
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/forgot-passwordIqala ukusetha kutsha iphasiwedi: nxa i-akhawunti elekheli le-imeyili elinikeziweyo ikhona, ithola i-imeyili elesixhumanisi sokusetha kutsha.POST /api/auth/sso/exchangeIsinyathelo sokucina sokungena nge-SSO (SAML/OIDC): itshintshanisa ikhodi yakanye evela ekuqondisweni kutsha ngethokheni yokufinyelela lerefresh token.