POST/api/auth/reset-password
Ustawia nowe hasło za pomocą tokenu resetowania z e-maila resetującego.
Wyślij `token` (z linku w e-mailu resetującym) i nowe `password` w treści JSON. Nie jest do tego wymagane logowanie. Hasło musi spełniać minimalne wymagania Zentor App. W przypadku powodzenia serwer odpowiada `{"ok":true}`; następnie użytkownik loguje się nowym hasłem. Nieprawidłowy, wygasły lub już wykorzystany token oraz hasło niespełniające minimalnych wymagań skutkują kodem 400 `VALIDATION_ERROR`. Token jest zużywany po pomyślnym użyciu; aby ponownie zmienić hasło, rozpocznij nowy proces przez `POST /api/auth/forgot-password`. Punkt końcowy jest ograniczony do 10 żądań na 15 minut na adres IP. Token i hasło przesyłaj wyłącznie w treści żądania przez HTTPS, nigdy jako parametr URL.
Przegląd
Wywołanie: POST /api/auth/reset-password. 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: token (body), password (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
token(body, string, wymagane)— Token resetowania z e-mailapassword(body, string, wymagane)— Nowe hasłoPrzykładowe żądanie
{"token":"<token z e-maila do resetowania hasła>","password":"NoweBezpieczneHaslo!"}Przykładowa odpowiedź
{"ok":true}Kody błędów
400 VALIDATION_ERROR — Token jest nieprawidłowy, wygasły lub już wykorzystany, albo hasło nie spełnia minimalnych wymagań.Zweryfikowane zachowanie
Nieprawidłowy token zwraca 400 `VALIDATION_ERROR`. Przypadek sukcesu (200 `{"ok":true}`) jest opisany na podstawie dokumentowanego przebiegu.
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/sso/exchangeOstatni krok logowania SSO (SAML/OIDC): wymienia jednorazowy kod z przekierowania na token dostępu i refresh token.