POST/api/auth/refresh

Byter en giltig refresh-token mot ett nytt par av åtkomsttoken och refresh-token.

Skicka det senast mottagna `refreshToken` i JSON-kroppen. Svaret innehåller en ny `token` och en ny `refreshToken`. Varje refresh-token kan användas endast en gång och är som standard giltig i sju dagar; spara den nya token efter varje anrop och kassera den gamla. En saknad, ogiltig, utgången eller redan använd refresh-token resulterar i 400 `VALIDATION_ERROR`. Användaren måste då logga in igen via `POST /api/auth/login`. Eftersom en refresh-token förbrukas vid användning bör en klient undvika parallella förnyelser.

Översikt

Anrop: POST /api/auth/refresh. Endpointen tillhör gruppen ”Autentisering” i Zentor Apps API. Den är offentligt tillgänglig och kräver ingen autentisering. Anropet är inte idempotent: Varje lyckat anrop utlöser åtgärden på nytt. Obligatoriska parametrar: refreshToken (body). Dokumenterade felfall: 400 VALIDATION_ERROR. Exempelsvaret nedan visar strukturen för ett lyckat svar i JSON-format.

Autentisering & säkerhet

Ingen autentisering krävs

Idempotent: Nej

Parametrar

refreshToken(body, string, obligatorisk)— Senast utfärdade refresh-token

Exempel på request

{"refreshToken":"<Refresh-token från /login>"}

Exempel på response

{"ok":true,"token":"<ny JWT>","refreshToken":"<ny refresh-token>"}

Felkoder

400 VALIDATION_ERROR — Refresh-token saknas, är ogiltig, utgången eller har redan använts.

Verifierat beteende

En giltig refresh-token returnerar ett nytt tokenpar; en ogiltig token returnerar 400 `VALIDATION_ERROR`.

Autentisering

Relaterade artiklar

← Autentisering