POST/api/auth/refresh
Bytter ut et gyldig refresh-token med et nytt par av tilgangstoken og refresh-token.
Send det sist mottatte `refreshToken` i JSON-kroppen. Svaret inneholder et nytt `token` og et nytt `refreshToken`. Hvert refresh-token kan bare brukes én gang og er som standard gyldig i sju dager; lagre det nye tokenet etter hvert kall, og forkast det gamle. Et manglende, ugyldig, utløpt eller allerede brukt refresh-token resulterer i 400 `VALIDATION_ERROR`. Brukeren må da logge inn på nytt via `POST /api/auth/login`. Siden et refresh-token forbrukes ved bruk, bør en klient unngå parallelle fornyelser.
Oversikt
Kall: POST /api/auth/refresh. 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: refreshToken (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
refreshToken(body, string, påkrevd)— Sist utstedte refresh-tokenEksempel på forespørsel
{"refreshToken":"<Refresh-token fra /login>"}Eksempel på svar
{"ok":true,"token":"<nytt JWT>","refreshToken":"<nytt refresh-token>"}Feilkoder
400 VALIDATION_ERROR — Refresh-tokenet mangler, er ugyldig, utløpt eller allerede brukt.Verifisert oppførsel
Et gyldig refresh-token returnerer et nytt tokenpar; et ugyldig token 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/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/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.