POST/api/auth/refresh

Vymení platný refresh token za novú dvojicu prístupového tokenu a refresh tokenu.

V JSON tele odošlite najnovšie získaný `refreshToken`. Odpoveď obsahuje nový `token` a nový `refreshToken`. Každý refresh token je použiteľný iba raz a štandardne je platný sedem dní; po každom volaní uložte nový token a starý zahoďte. Chýbajúci, neplatný, exspirovaný alebo už použitý refresh token vedie ku kódu 400 `VALIDATION_ERROR`. Používateľ sa potom musí znovu prihlásiť cez `POST /api/auth/login`. Pretože sa refresh token použitím spotrebuje, klient by sa mal vyhnúť súbežným obnovám.

Prehľad

Volanie: POST /api/auth/refresh. Tento endpoint patrí do skupiny „Autentifikácia“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie nie je idempotentné: Každé úspešné volanie akciu spustí znova. Povinné parametre: refreshToken (body). Zdokumentované chybové prípady: 400 VALIDATION_ERROR. Ukážková odpoveď nižšie zobrazuje štruktúru úspešnej odpovede vo formáte JSON.

Autentifikácia a zabezpečenie

Nevyžaduje sa žiadna autentifikácia

Idempotentné: Nie

Parametre

refreshToken(body, string, povinné)— Najnovšie vydaný refresh token

Príklad požiadavky

{"refreshToken":"<refresh token z /login>"}

Príklad odpovede

{"ok":true,"token":"<nový JWT>","refreshToken":"<nový refresh token>"}

Chybové kódy

400 VALIDATION_ERROR — Refresh token chýba, je neplatný, exspirovaný alebo už bol použitý.

Overené správanie

Platný refresh token vráti novú dvojicu tokenov; neplatný token vráti 400 `VALIDATION_ERROR`.

Autentifikácia

Súvisiace články

← Autentifikácia