POST/api/auth/sso/exchange
Ultimul pas al unei autentificări SSO (SAML/OIDC): schimbă codul de unică folosință din redirecționare pentru un token de acces și un refresh token.
După autentificarea la furnizorul de identitate, Zentor App redirecționează browserul cu un cod de unică folosință în parametrul de interogare `sso_code`. Trimiteți acest cod în câmpul `code`. Răspunsul conține `token` și `refreshToken`, ca la o autentificare obișnuită. Fiecare cod este valabil o singură dată și pentru puțin timp. Un cod deja utilizat, expirat sau invalid are ca rezultat 400 `SSO_EXCHANGE_INVALID`; utilizatorul repornește apoi autentificarea SSO. Prin urmare, apelul nu este idempotent.
Prezentare generală
Apel: POST /api/auth/sso/exchange. Acest endpoint aparține grupului „Autentificare” al API-ului Zentor App. Este accesibil public și nu necesită autentificare. Apelul nu este idempotent: fiecare apel reușit declanșează din nou acțiunea. Parametri obligatorii: code (body). Cazuri de eroare documentate: 400 SSO_EXCHANGE_INVALID. Răspunsul exemplu de mai jos arată structura unui răspuns reușit în format JSON.
Autentificare și securitate
Nu este necesară autentificarea
Idempotent: Nu
Parametri
code(body, string, obligatoriu)— Cod de unică folosință din redirecționarea SSOExemplu de cerere
{"code":"<Cod unic din redirectul de callback SSO>"}Exemplu de răspuns
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Coduri de eroare
400 SSO_EXCHANGE_INVALID — Codul este invalid, deja utilizat sau expirat.Comportament verificat
Un cod invalid returnează 400 `SSO_EXCHANGE_INVALID`. Cazul de succes presupune o autentificare completă la furnizorul de identitate configurat.
Autentificare
POST /api/auth/loginAutentifică un utilizator cu adresa de e-mail sau numele de utilizator și parola, și emite un token de acces (JWT) și un refresh token.POST /api/auth/refreshSchimbă un refresh token valid pentru o nouă pereche de token de acces și refresh token.POST /api/auth/forgot-passwordInițiază resetarea unei parole: dacă există un cont cu adresa de e-mail indicată, acesta primește un e-mail cu un link de resetare.POST /api/auth/reset-passwordSetează o parolă nouă folosind tokenul de resetare din e-mailul de resetare.