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-postadress

Exempel 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

Relaterade artiklar

← Autentisering