POST/api/auth/forgot-password

Starter nullstilling av passord: Hvis det finnes en konto med den angitte e-postadressen, mottar den en e-post med en lenke for nullstilling.

Send kontoens e-postadresse i feltet `email`. Svaret `{"ok":true}` er med vilje alltid det samme – uavhengig av om en konto finnes – slik at dette endepunktet ikke kan brukes til å finne ut hvilke adresser som er registrert. Det nye passordet settes deretter med tokenet fra e-posten via `POST /api/auth/reset-password`. Mangler feltet `email`, eller er det tomt, svarer endepunktet med 400 `VALIDATION_ERROR`. Som beskyttelse mot misbruk er antallet forespørsler per IP-adresse begrenset (429 `RATE_LIMIT_EXCEEDED`).

Oversikt

Kall: POST /api/auth/forgot-password. Endepunktet tilhører gruppen «Autentisering» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er idempotent: Gjentatte kall med de samme opplysningene gir samme resultat. Obligatoriske parametere: email (body). Dokumenterte feiltilfeller: 400 VALIDATION_ERROR. Eksempelsvaret nedenfor viser strukturen til et vellykket svar i JSON-format.

Autentisering og sikring

Ingen autentisering påkrevd

Idempotent: Ja

Parametere

email(body, string, påkrevd)— Kontoens e-postadresse

Eksempel på forespørsel

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

Eksempel på svar

{"ok":true}

Feilkoder

400 VALIDATION_ERROR — Feltet `email` mangler eller er tomt.

Verifisert oppførsel

Svaret er 200 `{"ok":true}`, uavhengig av om kontoen finnes; et manglende e-postfelt returnerer 400 `VALIDATION_ERROR`.

Autentisering

Relaterte artikler

← Autentisering