POST/api/auth/forgot-password
Huanzisha kuweka upya nenosiri: ikiwa akaunti yenye anwani ya barua pepe iliyotolewa ipo, hupokea barua pepe yenye kiungo cha kuweka upya.
Tumeni anwani ya barua pepe ya akaunti kwenye sehemu `email`. Jibu `{"ok":true}` huwa sawa kwa makusudi – iwe akaunti ipo au haipo – ili kituo hiki kisiweze kutambua ni anwani zipi zilizosajiliwa. Nenosiri jipya kisha huwekwa kwa tokeni kutoka barua pepe kupitia `POST /api/auth/reset-password`. Ikiwa sehemu `email` haipo au ni tupu, kituo hujibu na 400 `VALIDATION_ERROR`. Ili kuzuia matumizi mabaya, idadi ya maombi kwa kila anwani ya IP imewekwa kikomo (429 `RATE_LIMIT_EXCEEDED`).
Muhtasari
Mwito: POST /api/auth/forgot-password. Endpoint hii ni sehemu ya kundi la “Uthibitishaji” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu ni idempotent: miito inayorudiwa yenye data ileile hurudisha matokeo yaleyale. Vigezo vya lazima: email (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: Ndiyo
Vigezo
email(body, string, inahitajika)— Anwani ya barua pepe ya akauntiMfano wa ombi (request)
{"email":"user@example.com"}Mfano wa jibu (response)
{"ok":true}Misimbo ya hitilafu
400 VALIDATION_ERROR — Sehemu `email` haipo au ni tupu.Tabia iliyoangaliwa
Jibu ni 200 `{"ok":true}`, bila kujali akaunti ipo au haipo; sehemu ya barua pepe inayokosekana hutoa 400 `VALIDATION_ERROR`.
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/reset-passwordHuweka nenosiri jipya kwa tokeni ya reset kutoka barua pepe ya 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.