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-token

Eksempel 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

Relaterte artikler

← Autentisering