POST/api/auth/reset-password

Setter et nytt passord med reset-tokenet fra nullstillings-e-posten.

Send `token` (fra lenken i nullstillings-e-posten) og det nye `password` i JSON-kroppen. Innlogging er ikke nødvendig for dette. Passordet må oppfylle Zentor Apps minimumskrav. Ved suksess svarer serveren med `{"ok":true}`; deretter logger brukeren inn med det nye passordet. Et ugyldig, utløpt eller allerede brukt token samt et passord som ikke oppfyller minimumskravene, resulterer i 400 `VALIDATION_ERROR`. Et token er forbrukt etter vellykket bruk; for en ny endring starter du en ny prosess via `POST /api/auth/forgot-password`. Endepunktet er begrenset til 10 forespørsler per 15 minutter per IP-adresse. Overfør bare token og passord i request-kroppen via HTTPS, aldri som URL-parametre.

Oversikt

Kall: POST /api/auth/reset-password. Endepunktet tilhører gruppen «Autentisering» i API-et til Zentor App. Det er offentlig tilgjengelig og krever ingen autentisering. Kallet er ikke idempotent: Hvert vellykket kall utløser handlingen på nytt. Obligatoriske parametere: token (body), password (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: Nei

Parametere

token(body, string, påkrevd)— Reset-token fra e-posten
password(body, string, påkrevd)— Nytt passord

Eksempel på forespørsel

{"token":"<Token fra e-posten for tilbakestilling>","password":"NyttSikkertPassord!"}

Eksempel på svar

{"ok":true}

Feilkoder

400 VALIDATION_ERROR — Tokenet er ugyldig, utløpt eller allerede brukt, eller passordet oppfyller ikke minimumskravene.

Verifisert oppførsel

Et ugyldig token returnerer 400 `VALIDATION_ERROR`. Suksesstilfellet (200 `{"ok":true}`) er beskrevet basert på det dokumenterte forløpet.

Autentisering

Relaterte artikler

← Autentisering