POST/api/auth/sso/exchange
Danho repedzisiro rekupinda ne-SSO (SAML/OIDC): inotsinhanisa kodhi yekamwe chete inobva pakudzoserwa netokheni yekuwana nerefresh token.
Mushure mekupinda kumupi wezita, Zentor App inodzoserazve bhurauza netokheni yekamwe chete pamunda wemubvunzo unonzi `sso_code`. Tumirai kodhi iyi mumunda unonzi `code`. Mhinduro ine `token` ne`refreshToken` sezvinoitika kana kupinda kwakajairika. Kodhi imwe neimwe inoshanda kamwe chete uye kwenguva pfupi. Kodhi yakatoshandiswa, yapera nguva kana isingashandi, inoguma na-400 `SSO_EXCHANGE_INVALID`; mushandisi anotangazve kupinda kweSSO. Saka dana iri harisi idempotent.
Pfupiso
Kudana: POST /api/auth/sso/exchange. Endpoint iyi ndeyeboka re“Kusimbiswa” reAPI yeZentor App. Inowanikwa neveruzhinji uye haidi kusimbiswa (authentication). Kudana uku hakusi idempotent: kudana kwese kwese kunobudirira kunotangisa chiito zvakare. Maparameter anodiwa: code (body). Zviitiko zvezvikanganiso zvakanyorwa: 400 SSO_EXCHANGE_INVALID. Mhinduro yemuenzaniso iri pazasi inoratidza chimiro chemhinduro inobudirira muJSON format.
Kusimbiswa nekuchengetedza
Hapana kusimbiswa kunodiwa
Idempotent: Kwete
Maparameter
code(body, string, zvinodiwa)— Kodhi yekamwe chete inobva kudzoreredzo yeSSOMuenzaniso wechikumbiro
{"code":"<Kodhi yekamwe chete kubva muSSO callback redirect>"}Muenzaniso wemhinduro
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Makodhi ekukanganisa
400 SSO_EXCHANGE_INVALID — Kodhi isingashandi, yakatoshandiswa kana yapera nguva.Mafambiro akaongororwa
Kodhi isingashandi inopa 400 `SSO_EXCHANGE_INVALID`. Mamiriro ekubudirira anoda kupinda kwakazara kumupi wezita akagadzirirwa.
Kusimbiswa
POST /api/auth/loginInopinza mushandisi ne-email kana zita rekushandisa nepassword uye inobudisa tokheni yekuwana (JWT) pamwe nerefresh token.POST /api/auth/refreshInotsinhanisa refresh token inoshanda nechigadzirwa chitsva chetokheni yekuwana nerefresh token.POST /api/auth/forgot-passwordInotanga kuseta zvekare password: kana akaundi ine email yakapiwa iripo, inogamuchira email ine link yekuseta zvekare.POST /api/auth/reset-passwordInoseta password itsva netokheni yereset inobva memeemail yekuseta zvekare.