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-tokenExempel 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
POST /api/auth/loginLoggar in en användare med e-postadress eller användarnamn och lösenord och utfärdar en åtkomsttoken (JWT) samt en refresh-token.POST /api/auth/forgot-passwordStartar en återställning av lösenord: om det finns ett konto med den angivna e-postadressen får det ett e-postmeddelande med en länk för återställning.POST /api/auth/reset-passwordStäller in ett nytt lösenord med reset-token från återställningsmeddelandet.POST /api/auth/sso/exchangeSista steget i en SSO-inloggning (SAML/OIDC): byter engångskoden från omdirigeringen mot en åtkomsttoken och en refresh-token.