POST/api/auth/forgot-password
Inotanga kuseta zvekare password: kana akaundi ine email yakapiwa iripo, inogamuchira email ine link yekuseta zvekare.
Tumirai email yeakaundi mumunda unonzi `email`. Mhinduro inonzi `{"ok":true}` inogara yakafanana nemaune – pasinei nekuti akaundi iripo kana kwete – kuitira kuti chibatanidzo ichi chisagoneswe kutsvaga ma email akanyoreswa. Password itsva inozosetwa nazvo tokheni inobva meemail kuburikidza ne`POST /api/auth/reset-password`. Kana munda unonzi `email` usipo kana usina chinhu, chibatanidzo chinopindura ne400 `VALIDATION_ERROR`. Kudzivirira kushandiswa zvisizvo, huwandu hwezvikumbiro pakero yeIP imwe neimwe hwakaganhurirwa (429 `RATE_LIMIT_EXCEEDED`).
Pfupiso
Kudana: POST /api/auth/forgot-password. Endpoint iyi ndeyeboka re“Kusimbiswa” reAPI yeZentor App. Inowanikwa neveruzhinji uye haidi kusimbiswa (authentication). Kudana uku idempotent: kudana kakawanda neruzivo rumwe chete kunodzosa mhedzisiro imwe chete. Maparameter anodiwa: email (body). Zviitiko zvezvikanganiso zvakanyorwa: 400 VALIDATION_ERROR. Mhinduro yemuenzaniso iri pazasi inoratidza chimiro chemhinduro inobudirira muJSON format.
Kusimbiswa nekuchengetedza
Hapana kusimbiswa kunodiwa
Idempotent: Hongu
Maparameter
email(body, string, zvinodiwa)— Email yeakaundiMuenzaniso wechikumbiro
{"email":"user@example.com"}Muenzaniso wemhinduro
{"ok":true}Makodhi ekukanganisa
400 VALIDATION_ERROR — Munda unonzi `email` usipo kana usina chinhu.Mafambiro akaongororwa
Mhinduro ndi200 `{"ok":true}`, pasinei nekuti akaundi iripo kana kwete; munda weemail usipo unopa 400 `VALIDATION_ERROR`.
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/reset-passwordInoseta password itsva netokheni yereset inobva memeemail yekuseta zvekare.POST /api/auth/sso/exchangeDanho repedzisiro rekupinda ne-SSO (SAML/OIDC): inotsinhanisa kodhi yekamwe chete inobva pakudzoserwa netokheni yekuwana nerefresh token.