POST/api/auth/sso/exchange
Ostatni krok logowania SSO (SAML/OIDC): wymienia jednorazowy kod z przekierowania na token dostępu i refresh token.
Po zalogowaniu u dostawcy identyfikacji Zentor App przekierowuje przeglądarkę z jednorazowym kodem w parametrze zapytania `sso_code`. Wyślij ten kod w polu `code`. Odpowiedź zawiera `token` i `refreshToken`, podobnie jak przy zwykłym logowaniu. Każdy kod jest ważny tylko raz i tylko krótko. Już wykorzystany, wygasły lub nieprawidłowy kod skutkuje kodem 400 `SSO_EXCHANGE_INVALID`; użytkownik wtedy ponownie zaczyna logowanie SSO. Wywołanie nie jest więc idempotentne.
Przegląd
Wywołanie: POST /api/auth/sso/exchange. Ten endpoint należy do grupy „Uwierzytelnianie” API Zentor App. Jest publicznie dostępny i nie wymaga uwierzytelniania. Wywołanie nie jest idempotentne: każde udane wywołanie ponownie uruchamia akcję. Parametry wymagane: code (body). Udokumentowane przypadki błędów: 400 SSO_EXCHANGE_INVALID. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
Idempotentny: Nie
Parametry
code(body, string, wymagane)— Jednorazowy kod z przekierowania SSOPrzykładowe żądanie
{"code":"<kod jednorazowy z przekierowania SSO callback>"}Przykładowa odpowiedź
{"ok":true,"token":"<JWT>","refreshToken":"<Refresh-Token>"}Kody błędów
400 SSO_EXCHANGE_INVALID — Kod jest nieprawidłowy, już wykorzystany lub wygasły.Zweryfikowane zachowanie
Nieprawidłowy kod zwraca 400 `SSO_EXCHANGE_INVALID`. Przypadek sukcesu wymaga pełnego zalogowania u skonfigurowanego dostawcy identyfikacji.
Uwierzytelnianie
POST /api/auth/loginLoguje użytkownika za pomocą adresu e-mail lub nazwy użytkownika i hasła oraz wydaje token dostępu (JWT) i refresh token.POST /api/auth/refreshWymienia ważny refresh token na nową parę tokenu dostępu i refresh tokenu.POST /api/auth/forgot-passwordRozpoczyna resetowanie hasła: jeśli istnieje konto z podanym adresem e-mail, otrzymuje e-mail z linkiem do zresetowania.POST /api/auth/reset-passwordUstawia nowe hasło za pomocą tokenu resetowania z e-maila resetującego.