POST/api/auth/refresh
Hubadilishana tokeni ya refresh iliyo halali kwa jozi mpya ya tokeni ya ufikiaji na tokeni ya refresh.
Tumeni `refreshToken` iliyopokelewa mwishoni kwenye JSON body. Jibu lina `token` mpya na `refreshToken` mpya. Tokeni ya refresh kila moja hutumika mara moja tu na kwa kawaida ni halali kwa siku saba; baada ya kila wito, hifadhini tokeni mpya na mtupe ya zamani. Tokeni ya refresh inayokosekana, batili, iliyopitwa muda au iliyotumika tayari husababisha 400 `VALIDATION_ERROR`. Mtumiaji anapaswa kuingia tena kupitia `POST /api/auth/login`. Kwa kuwa tokeni ya refresh huliwa ikitumika, mteja anapaswa kuepuka masasisho sambamba.
Muhtasari
Mwito: POST /api/auth/refresh. 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: refreshToken (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
refreshToken(body, string, inahitajika)— Tokeni ya refresh iliyotolewa mwishoniMfano wa ombi (request)
{"refreshToken":"<Refresh token kutoka /login>"}Mfano wa jibu (response)
{"ok":true,"token":"<JWT mpya>","refreshToken":"<Refresh token mpya>"}Misimbo ya hitilafu
400 VALIDATION_ERROR — Tokeni ya refresh haipo, ni batili, imepitwa muda au imetumika tayari.Tabia iliyoangaliwa
Tokeni ya refresh iliyo halali hutoa jozi mpya ya tokeni; tokeni batili 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/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/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.