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-postadresseEksempel 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
POST /api/auth/loginLogger inn en bruker med e-postadresse eller brukernavn og passord og utsteder et tilgangstoken (JWT) samt et refresh-token.POST /api/auth/refreshBytter ut et gyldig refresh-token med et nytt par av tilgangstoken og refresh-token.POST /api/auth/reset-passwordSetter et nytt passord med reset-tokenet fra nullstillings-e-posten.POST /api/auth/sso/exchangeSiste trinn i en SSO-innlogging (SAML/OIDC): bytter ut engangskoden fra omdirigeringen med et tilgangstoken og et refresh-token.