POST/api/auth/sso/exchange
Hatua 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.
Baada ya kuingia kwa mtoa huduma wa utambulisho, Zentor App huelekeza kivinjari tena na msimbo wa mara moja katika kigezo cha swali `sso_code`. Tumeni msimbo huu kwenye sehemu `code`. Jibu lina `token` na `refreshToken` kama kuingia kwa kawaida. Msimbo kila mmoja ni halali mara moja na kwa muda mfupi tu. Msimbo ulioshatumika, uliopitwa muda au batili husababisha 400 `SSO_EXCHANGE_INVALID`; mtumiaji huanza tena kuingia kwa SSO. Hivyo wito huu si idempotent.
Muhtasari
Mwito: POST /api/auth/sso/exchange. 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: code (body). Hali za hitilafu zilizoandikwa: 400 SSO_EXCHANGE_INVALID. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Hapana
Vigezo
code(body, string, inahitajika)— Msimbo wa mara moja kutoka uelekezaji wa SSOMfano wa ombi (request)
{"code":"<Msimbo wa matumizi moja kutoka kwa uelekezaji wa SSO callback>"}Mfano wa jibu (response)
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Misimbo ya hitilafu
400 SSO_EXCHANGE_INVALID — Msimbo ni batili, umetumika tayari au umepitwa muda.Tabia iliyoangaliwa
Msimbo batili hutoa 400 `SSO_EXCHANGE_INVALID`. Hali ya mafanikio inahitaji kuingia kikamilifu kwa mtoa huduma wa utambulisho aliyesanidiwa.
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/reset-passwordHuweka nenosiri jipya kwa tokeni ya reset kutoka barua pepe ya kuweka upya.