POST/api/auth/reset-password
Nastaví nové heslo pomocou resetovacieho tokenu z resetovacieho e-mailu.
V JSON tele odošlite `token` (z odkazu v resetovacom e-maile) a nové `password`. Prihlásenie na to nie je potrebné. Heslo musí splniť minimálne požiadavky Zentor App. Pri úspechu server odpovie `{"ok":true}`; potom sa používateľ prihlási novým heslom. Neplatný, exspirovaný alebo už použitý token a heslo nesplňujúce minimálne požiadavky vedú ku kódu 400 `VALIDATION_ERROR`. Token sa po úspešnom použití spotrebuje; na ďalšiu zmenu spustite nový postup cez `POST /api/auth/forgot-password`. Endpoint je obmedzený na 10 požiadaviek za 15 minút na IP adresu. Token a heslo prenášajte iba v tele požiadavky cez HTTPS, nikdy ako parameter URL.
Prehľad
Volanie: POST /api/auth/reset-password. 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: token (body), password (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
token(body, string, povinné)— Resetovací token z e-mailupassword(body, string, povinné)— Nové hesloPríklad požiadavky
{"token":"<Token z e-mailu na obnovenie hesla>","password":"NoveBezpecneHeslo!"}Príklad odpovede
{"ok":true}Chybové kódy
400 VALIDATION_ERROR — Token je neplatný, exspirovaný alebo už použitý, alebo heslo nesplňuje minimálne požiadavky.Overené správanie
Neplatný token vráti 400 `VALIDATION_ERROR`. Úspešný prípad (200 `{"ok":true}`) je popísaný na základe zdokumentovaného postupu.
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/refreshVymení platný refresh token za novú dvojicu prístupového tokenu a refresh tokenu.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/sso/exchangePosledný krok prihlásenia SSO (SAML/OIDC): vymení jednorazový kód z presmerovania za prístupový token a refresh token.