POST/api/auth/reset-password
Huweka nenosiri jipya kwa tokeni ya reset kutoka barua pepe ya kuweka upya.
Tumeni `token` (kutoka kiungo cha barua pepe ya kuweka upya) na `password` mpya kwenye JSON body. Kuingia hakuhitajiki. Nenosiri lazima lizingatie mahitaji ya chini ya Zentor App. Ikifanikiwa, seva hujibu na `{"ok":true}`; baada ya hapo mtumiaji anaingia na nenosiri jipya. Tokeni batili, iliyopitwa muda au iliyotumika tayari, pamoja na nenosiri lisilozingatia mahitaji ya chini, husababisha 400 `VALIDATION_ERROR`. Tokeni huliwa baada ya kutumika kwa mafanikio; kwa mabadiliko mengine, anzisheni mchakato mpya kupitia `POST /api/auth/forgot-password`. Kituo kimewekwa kikomo cha maombi 10 kwa dakika 15 kwa kila anwani ya IP. Tumeni tokeni na nenosiri tu kwenye request body kupitia HTTPS, kamwe kama vigezo vya URL.
Muhtasari
Mwito: POST /api/auth/reset-password. Endpoint hii ni sehemu ya kundi la “Uthibitishaji” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: token (body), password (body). Hali za hitilafu zilizoandikwa: 400 VALIDATION_ERROR. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Hapana
Vigezo
token(body, string, inahitajika)— Tokeni ya reset kutoka barua pepepassword(body, string, inahitajika)— Nenosiri jipyaMfano wa ombi (request)
{"token":"<Tokeni kutoka barua pepe ya kuweka upya nenosiri>","password":"NenosiriJipyaSalama!"}Mfano wa jibu (response)
{"ok":true}Misimbo ya hitilafu
400 VALIDATION_ERROR — Tokeni ni batili, imepitwa muda au imetumika tayari, au nenosiri halizingatii mahitaji ya chini.Tabia iliyoangaliwa
Tokeni batili hutoa 400 `VALIDATION_ERROR`. Hali ya mafanikio (200 `{"ok":true}`) imeelezwa kulingana na mchakato ulioandikwa.
Uthibitishaji
POST /api/auth/loginHuingiza mtumiaji kwa anwani ya barua pepe au jina la mtumiaji na nenosiri na hutoa tokeni ya ufikiaji (JWT) pamoja na tokeni ya refresh.POST /api/auth/refreshHubadilishana tokeni ya refresh iliyo halali kwa jozi mpya ya tokeni ya ufikiaji na tokeni ya refresh.POST /api/auth/forgot-passwordHuanzisha kuweka upya nenosiri: ikiwa akaunti yenye anwani ya barua pepe iliyotolewa ipo, hupokea barua pepe yenye kiungo cha kuweka upya.POST /api/auth/sso/exchangeHatua ya mwisho ya kuingia kwa SSO (SAML/OIDC): hubadilishana msimbo wa mara moja kutoka kwa uelekezaji upya kwa tokeni ya ufikiaji na tokeni ya refresh.