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-postenpassword(body, string, påkrevd)— Nytt passordEksempel 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
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/forgot-passwordStarter nullstilling av passord: Hvis det finnes en konto med den angitte e-postadressen, mottar den en e-post med en lenke for nullstilling.POST /api/auth/sso/exchangeSiste trinn i en SSO-innlogging (SAML/OIDC): bytter ut engangskoden fra omdirigeringen med et tilgangstoken og et refresh-token.