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 tokenPrí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
POST /api/auth/loginPrihlási používateľa pomocou e-mailovej adresy alebo používateľského mena a hesla a vydá prístupový token (JWT) a refresh token.POST /api/auth/forgot-passwordSpustí resetovanie hesla: ak existuje účet so zadanou e-mailovou adresou, dostane e-mail s odkazom na resetovanie.POST /api/auth/reset-passwordNastaví nové heslo pomocou resetovacieho tokenu z resetovacieho e-mailu.POST /api/auth/sso/exchangePosledný krok prihlásenia SSO (SAML/OIDC): vymení jednorazový kód z presmerovania za prístupový token a refresh token.