POST/api/auth/sso/exchange
Posledný krok prihlásenia SSO (SAML/OIDC): vymení jednorazový kód z presmerovania za prístupový token a refresh token.
Po prihlásení u poskytovateľa identity presmeruje Zentor App prehliadač s jednorazovým kódom v parametri dotazu `sso_code`. Tento kód odošlite v poli `code`. Odpoveď obsahuje `token` a `refreshToken`, podobne ako pri bežnom prihlásení. Každý kód platí len raz a len krátko. Už použitý, exspirovaný alebo neplatný kód vedie ku kódu 400 `SSO_EXCHANGE_INVALID`; používateľ potom znovu začne prihlásenie SSO. Volanie preto nie je idempotentné.
Prehľad
Volanie: POST /api/auth/sso/exchange. Tento endpoint patrí do skupiny „Autentifikácia“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: code (body). Zdokumentované chybové prípady: 400 SSO_EXCHANGE_INVALID. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.
Autentifikácia a zabezpečenie
Nevyžaduje sa žiadna autentifikácia
Idempotentné: Nie
Parametre
code(body, string, povinné)— Jednorazový kód z presmerovania SSOPríklad požiadavky
{"code":"<jednorazový kód z presmerovania SSO callbacku>"}Príklad odpovede
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Chybové kódy
400 SSO_EXCHANGE_INVALID — Kód je neplatný, už použitý alebo exspirovaný.Overené správanie
Neplatný kód vráti 400 `SSO_EXCHANGE_INVALID`. Úspešný prípad predpokladá úplné prihlásenie u nastaveného poskytovateľa identity.
Autentifikácia
POST /api/auth/loginPrihlási používateľa pomocou e-mailovej adresy alebo používateľského mena a hesla a vydá prístupový token (JWT) a refresh token.POST /api/auth/refreshVymení platný refresh token za novú dvojicu prístupového tokenu a refresh tokenu.POST /api/auth/forgot-passwordSpustí resetovanie hesla: ak existuje účet so zadanou e-mailovou adresou, dostane e-mail s odkazom na resetovanie.POST /api/auth/reset-passwordNastaví nové heslo pomocou resetovacieho tokenu z resetovacieho e-mailu.