POST/api/auth/reset-password
Inoseta password itsva netokheni yereset inobva memeemail yekuseta zvekare.
Tumirai `token` (inobva kulink yemeemail yekuseta zvekare) nepassword `password` itsva mu JSON body. Kupinda hakudikanwi. Password inofanira kuenderana nezvinodiwa zvidikidiki zveZentor App. Kana zvabudirira, seva inopindura ne`{"ok":true}`; mushure meizvozvo mushandisi anopinda nepassword itsva. Tokheni isingashandi, yapera nguva kana yakatoshandiswa, pamwe nepassword isingaenderane nezvinodiwa zvidikidiki, zvinoguma na-400 `VALIDATION_ERROR`. Tokheni inopera mushure mekushandiswa zvakabudirira; kuti muchinje zvakare, tangai maitiro matsva ne`POST /api/auth/forgot-password`. Chibatanidzo chakaganhurirwa kuzvikumbiro gumi pamaminitsi gumi nemashanu pakero yeIP imwe neimwe. Tumirai tokheni nepassword mu request body chete kuburikidza neHTTPS, kwete semupharamita weURL.
Pfupiso
Kudana: POST /api/auth/reset-password. Endpoint iyi ndeyeboka re“Kusimbiswa” reAPI yeZentor App. Inowanikwa neveruzhinji uye haidi kusimbiswa (authentication). Kudana uku hakusi idempotent: kudana kwese kwese kunobudirira kunotangisa chiito zvakare. Maparameter anodiwa: token (body), password (body). Zviitiko zvezvikanganiso zvakanyorwa: 400 VALIDATION_ERROR. Mhinduro yemuenzaniso iri pazasi inoratidza chimiro chemhinduro inobudirira muJSON format.
Kusimbiswa nekuchengetedza
Hapana kusimbiswa kunodiwa
Idempotent: Kwete
Maparameter
token(body, string, zvinodiwa)— Tokheni yereset inobva memeemailpassword(body, string, zvinodiwa)— Password itsvaMuenzaniso wechikumbiro
{"token":"<Tokeni kubva muemail yekuseta patsva>","password":"PasswordItsvaYakachengeteka!"}Muenzaniso wemhinduro
{"ok":true}Makodhi ekukanganisa
400 VALIDATION_ERROR — Tokheni isingashandi, yapera nguva kana yakatoshandiswa, kana password isingaenderane nezvinodiwa zvidikidiki.Mafambiro akaongororwa
Tokheni isingashandi inopa 400 `VALIDATION_ERROR`. Mamiriro ekubudirira (200 `{"ok":true}`) anotsanangurwa maererano nemaitiro akanyorwa.
Kusimbiswa
POST /api/auth/loginInopinza mushandisi ne-email kana zita rekushandisa nepassword uye inobudisa tokheni yekuwana (JWT) pamwe nerefresh token.POST /api/auth/refreshInotsinhanisa refresh token inoshanda nechigadzirwa chitsva chetokheni yekuwana nerefresh token.POST /api/auth/forgot-passwordInotanga kuseta zvekare password: kana akaundi ine email yakapiwa iripo, inogamuchira email ine link yekuseta zvekare.POST /api/auth/sso/exchangeDanho repedzisiro rekupinda ne-SSO (SAML/OIDC): inotsinhanisa kodhi yekamwe chete inobva pakudzoserwa netokheni yekuwana nerefresh token.