POST/api/auth/sso/exchange
Zadnji korak prijave SSO (SAML/OIDC): zamenja enkratno kodo iz preusmeritve za dostopni žeton in žeton za obnovitev.
Po prijavi pri ponudniku identitete Zentor App preusmeri brskalnik nazaj z enkratno kodo v poizvedbenem parametru `sso_code`. Pošljite to kodo v polju `code`. Odgovor vsebuje `token` in `refreshToken` kot pri navadni prijavi. Vsaka koda velja le enkrat in le kratek čas. Že uporabljena, potekla ali neveljavna koda povzroči 400 `SSO_EXCHANGE_INVALID`; uporabnik nato ponovno zažene prijavo SSO. Klic zato ni idempotenten.
Pregled
Klic: POST /api/auth/sso/exchange. Ta endpoint spada v skupino »Avtentikacija« API-ja Zentor App. Je javno dostopen in ne zahteva overjanja. Klic ni idempotenten: vsak uspešen klic znova sproži dejanje. Obvezni parametri: code (body). Dokumentirani primeri napak: 400 SSO_EXCHANGE_INVALID. Spodnji primer odgovora prikazuje strukturo uspešnega odgovora v formatu JSON.
Avtentikacija in zaščita
Avtentikacija ni potrebna
Idempotentno: Ne
Parametri
code(body, string, obvezno)— Enkratna koda iz preusmeritve SSOPrimer zahteve
{"code":"<enkratna koda iz preusmeritve SSO-Callback>"}Primer odgovora
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Kode napak
400 SSO_EXCHANGE_INVALID — Koda je neveljavna, že uporabljena ali potekla.Preverjeno vedenje
Neveljavna koda vrne 400 `SSO_EXCHANGE_INVALID`. Primer uspeha predpostavlja popolno prijavo pri nastavljenem ponudniku identitete.
Avtentikacija
POST /api/auth/loginPrijavi uporabnika z e-poštnim naslovom ali uporabniškim imenom in geslom ter izda dostopni žeton (JWT) in žeton za obnovitev (refresh token).POST /api/auth/refreshZamenja veljaven žeton za obnovitev za nov par dostopnega žetona in žetona za obnovitev.POST /api/auth/forgot-passwordSproži ponastavitev gesla: če obstaja račun z navedenim e-poštnim naslovom, prejme e-pošto s povezavo za ponastavitev.POST /api/auth/reset-passwordNastavi novo geslo z žetonom za ponastavitev iz e-pošte.