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 mwishoni

Mfano 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

Makala zinazohusiana

← Uthibitishaji