POST/api/auth/forgot-password
Startar en återställning av lösenord: om det finns ett konto med den angivna e-postadressen får det ett e-postmeddelande med en länk för återställning.
Skicka kontots e-postadress i fältet `email`. Svaret `{"ok":true}` är medvetet alltid detsamma – oavsett om ett konto finns – så att denna slutpunkt inte kan användas för att ta reda på vilka adresser som är registrerade. Det nya lösenordet ställs sedan in med token från e-postmeddelandet via `POST /api/auth/reset-password`. Saknas fältet `email` eller är det tomt, svarar slutpunkten med 400 `VALIDATION_ERROR`. Som skydd mot missbruk är antalet förfrågningar per IP-adress begränsat (429 `RATE_LIMIT_EXCEEDED`).
Översikt
Anrop: POST /api/auth/forgot-password. Endpointen tillhör gruppen ”Autentisering” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är idempotent: Upprepade anrop med samma uppgifter ger samma resultat. Obligatoriska parametrar: email (body). Dokumenterade felfall: 400 VALIDATION_ERROR. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.
Autentisering & säkerhet
Ingen autentisering krävs
Idempotent: Ja
Parametrar
email(body, string, obligatorisk)— Kontots e-postadressExempel på request
{"email":"user@example.com"}Exempel på response
{"ok":true}Felkoder
400 VALIDATION_ERROR — Fältet `email` saknas eller är tomt.Verifierat beteende
Svaret är 200 `{"ok":true}`, oavsett om kontot finns; ett saknat e-postfält returnerar 400 `VALIDATION_ERROR`.
Autentisering
POST /api/auth/loginLoggar in en användare med e-postadress eller användarnamn och lösenord och utfärdar en åtkomsttoken (JWT) samt en refresh-token.POST /api/auth/refreshByter en giltig refresh-token mot ett nytt par av åtkomsttoken och refresh-token.POST /api/auth/reset-passwordStäller in ett nytt lösenord med reset-token från återställningsmeddelandet.POST /api/auth/sso/exchangeSista steget i en SSO-inloggning (SAML/OIDC): byter engångskoden från omdirigeringen mot en åtkomsttoken och en refresh-token.