POST/api/auth/forgot-password

Wysyła e-mail z resetem hasła, o ile istnieje konto z tym adresem. Odpowiada celowo zawsze tak samo (na tej podstawie nie da się wnioskować o istnieniu konta).

Strona „POST /api/auth/forgot-password — referencja API” opisuje obszar funkcjonalny wskazany w adresie URL. Istniejąca treść została uzupełniona o rzeczywisty przebieg, wymagania wstępne i znane ograniczenia. Zentor nie posiada systemu kluczy API dla deweloperów. W panelu używane są sesyjne tokeny JWT ważne dwanaście godzin oraz tokeny odświeżania ważne siedem dni; TOTP i SSO są opcjonalne. Tokeny osadzenia widżetu są wyświetlane jawnym tekstem tylko raz i są powiązane z dozwolonymi originami. Dokumentację dotyczącą `POST /api/auth/forgot-password` należy traktować jako wiążący opis techniczny tego konkretnego punktu końcowego. Decydujące są metoda, ścieżka, uwierzytelnianie, pola obowiązkowe, możliwe błędy oraz to, czy ponowne wywołanie wywołuje ten sam skutek. Ta sekcja pomocy https://zentor-app.de/hilfe/api-referenz/auth/auth.forgot_password nie może więc zawierać ogólnych haseł reklamowych, a jedynie możliwe do odtworzenia kroki integracji i udokumentowane przykłady odpowiedzi. Wywołanie `/api/auth/forgot-password` buduje się zgodnie z rejestrem (Registry). Trasy publiczne nie wymagają ogólnego klucza API dla deweloperów, ponieważ Zentor nie oferuje takiego systemu kluczy. Chronione trasy widżetu używają natomiast jednorazowo wyświetlanego tokenu osadzenia i weryfikacji originu. Status HTTP i treść JSON należy oceniać łącznie; samo pole `ok` nie zastępuje obsługi błędów. Podczas testowania `POST /api/auth/forgot-password` należy używać wartości zanonimizowanych. Rzeczywiste dane klientów, produkcyjne identyfikatory UUID, tokeny sesji i konkretne znaczniki czasu nie powinny trafiać do publicznych przykładów. Znany limit dla całej platformy wynosi 2 000 żądań w ciągu 15 minut; odrębny limit dla pojedynczego punktu końcowego nie jest udokumentowany. Nieidempotentnych wywołań POST nie wolno ponawiać na ślepo po niejasnym przerwaniu połączenia sieciowego. Typowe błędy integracji dla tej trasy wynikają z brakujących parametrów obowiązkowych, nieprawidłowych typów danych, wygasłych kodów jednorazowych, niedozwolonych originów lub niezaimplementowanego rekordu danych. Aplikacja powinna obsługiwać takie przypadki osobno i rejestrować komunikat błędu zwrócony przez punkt końcowy, nie zapisując przy tym poufnych treści. Udane żądanie potwierdza wyłącznie ten etap przetwarzania, a nie automatycznie powodzenie następującego po nim wysłania e-maila, płatności lub logowania SSO. Jest to bezpośrednio istotne dla „POST /api/auth/forgot-password”. Weryfikacja techniczna tej strony musi opierać się na rejestrze w `app/frontend/src/content/api-reference/` oraz na powiązanych trasach backendu. Adnotacje z testów na żywo mogą stwierdzać wyłącznie to, co zostało faktycznie sprawdzone. Test negatywny lub analogia w kodzie nie stanowi pełnego dowodu powodzenia. Dlatego w przypadku POST /api/auth/forgot-password — referencja API należy wyraźnie rozróżniać udokumentowaną strukturę, test automatyczny i bezpiecznie zaobserwowane zachowanie na żywo.

{"email":"user@example.com"}

{"ok":true}