POST/api/auth/refresh
Wymienia ważny refresh token na nową parę tokenu dostępu i refresh tokenu.
Wyślij w treści JSON ostatnio otrzymany `refreshToken`. Odpowiedź zawiera nowy `token` i nowy `refreshToken`. Każdy refresh token można wykorzystać tylko raz i domyślnie jest ważny siedem dni; po każdym wywołaniu zapisuj nowy token i odrzucaj stary. Brakujący, nieprawidłowy, wygasły lub już wykorzystany refresh token skutkuje kodem 400 `VALIDATION_ERROR`. Użytkownik musi wtedy ponownie zalogować się przez `POST /api/auth/login`. Ponieważ refresh token jest zużywany podczas użycia, klient powinien unikać równoległych odnowień.
Przegląd
Wywołanie: POST /api/auth/refresh. 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: refreshToken (body). Udokumentowane przypadki błędów: 400 VALIDATION_ERROR. Poniższa przykładowa odpowiedź pokazuje strukturę udanej odpowiedzi w formacie JSON.
Uwierzytelnianie i zabezpieczenia
Uwierzytelnianie nie jest wymagane
Idempotentny: Nie
Parametry
refreshToken(body, string, wymagane)— Ostatnio wydany refresh tokenPrzykładowe żądanie
{"refreshToken":"<token odświeżania z /login>"}Przykładowa odpowiedź
{"ok":true,"token":"<nowy JWT>","refreshToken":"<nowy token odświeżania>"}Kody błędów
400 VALIDATION_ERROR — Refresh token jest brakujący, nieprawidłowy, wygasły lub już wykorzystany.Zweryfikowane zachowanie
Prawidłowy refresh token zwraca nową parę tokenów; nieprawidłowy token zwraca 400 `VALIDATION_ERROR`.
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/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.POST /api/auth/sso/exchangeOstatni krok logowania SSO (SAML/OIDC): wymienia jednorazowy kod z przekierowania na token dostępu i refresh token.