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-mailu
password(body, string, povinné)— Nové heslo

Prí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

Súvisiace články

← Autentifikácia