POST/api/auth/reset-password
Isetha iphasiwedi entsha nge-token ye-reset evela kwi-imeyile yokusetwa kwakhona.
Thumela i`token` (evela kwikhonkco le-imeyile yokusetwa kwakhona) kunye ne`password` entsha kumzimba we-JSON. Ukungena akufuneki. Iphasiwedi kufuneka ihambelane neemfuno eziphantsi ze-Zentor App. Ukuba kuphumelele, iseva iphendula nge`{"ok":true}`; emva koko umsebenzisi angena ngephasiwedi entsha. I-token engasebenziyo, ephelelwe ixesha okanye yasele isetyenziswa, kunye nephasiwedi engahambelaniyo neemfuno eziphantsi, ikhokelela ku-400 `VALIDATION_ERROR`. I-token iqhwalelwa emva kokusetyenziswa ngempumelelo; ukuze kutshintshwe kwakhona, qala inkqubo entsha nge`POST /api/auth/forgot-password`. Isidibanisi sikhawulelwe kwizicelo ezili-10 kwimizuzu eli-15 kwidilesi ye-IP nganye. Thumela i-token kunye nephasiwedi kuphela kumzimba wesicelo nge-HTTPS, soloko ingengomgca we-URL.
Ushwankathelo
Ukubiza: POST /api/auth/reset-password. Le endpoint yeyeqela elithi “Uqinisekiso” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza ayisiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kwakhona. Iipharamitha ezinyanzelekileyo: token (body), password (body). Iimeko zeempazamo ezibhaliweyo: 400 VALIDATION_ERROR. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.
Ukuqinisekiswa nokhuseleko
Akukho kuqinisekiswa kufunekayo
Idempotent: Hayi
Iiparamitha
token(body, string, kuyafuneka)— I-token ye-reset evela kwi-imeyilepassword(body, string, kuyafuneka)— Iphasiwedi entshaUmzekelo we-request
{"token":"<Ithokheni evela kwi-imeyile yokusetha kwakhona>","password":"IphasiwediEntshaEkhuselekileyo!"}Umzekelo we-response
{"ok":true}Iikhowudi zeempazamo
400 VALIDATION_ERROR — I-token ayisebenzi, iphelelwe ixesha okanye yasele isetyenziswa, okanye iphasiwedi ayihambelani neemfuno eziphantsi.Ukuziphatha okujongwe
I-token engasebenziyo inika i-400 `VALIDATION_ERROR`. Imeko yempumelelo (i-200 `{"ok":true}`) ichazwe ngokwenkqubo ebhaliweyo.
Uqinisekiso
POST /api/auth/loginIngenisa umsebenzisi ngedilesi ye-imeyile okanye igama lomsebenzisi kunye nephasiwedi kwaye ikhuphe i-token yokufikelela (JWT) kunye ne-refresh token.POST /api/auth/refreshTshintshela i-refresh-token esebenzayo ngesibini esitsha se-token yokufikelela kunye ne-refresh token.POST /api/auth/forgot-passwordIqalisa ukusetwa kwakhona kwephasiwedi: ukuba i-akhawunti enedilesi ye-imeyile enikeziweyo ikhona, ifumana i-imeyile enekhonkco lokusetwa kwakhona.POST /api/auth/sso/exchangeInyathelo lokugqibela lokungena nge-SSO (SAML/OIDC): itshintshanisa ikhowudi yesihlandlo esinye evela kwisiqondiso kabusha nge-token yokufikelela kunye ne-refresh token.