POST/api/auth/forgot-password
Spustí resetovanie hesla: ak existuje účet so zadanou e-mailovou adresou, dostane e-mail s odkazom na resetovanie.
V poli `email` odošlite e-mailovú adresu účtu. Odpoveď `{"ok":true}` je zámerne vždy rovnaká – bez ohľadu na to, či účet existuje –, aby cez tento endpoint nebolo možné zistiť, ktoré adresy sú registrované. Nové heslo sa potom nastaví pomocou tokenu z e-mailu cez `POST /api/auth/reset-password`. Ak pole `email` chýba alebo je prázdne, endpoint odpovie kódom 400 `VALIDATION_ERROR`. Na ochranu proti zneužitiu je počet požiadaviek na IP adresu obmedzený (429 `RATE_LIMIT_EXCEEDED`).
Prehľad
Volanie: POST /api/auth/forgot-password. Tento endpoint patrí do skupiny „Autentifikácia“ API aplikácie Zentor App. Je verejne dostupný a nevyžaduje žiadnu autentifikáciu. Volanie je idempotentné: Opakované volania s rovnakými údajmi vracajú rovnaký výsledok. Povinné parametre: email (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é: Áno
Parametre
email(body, string, povinné)— E-mailová adresa účtuPríklad požiadavky
{"email":"user@example.com"}Príklad odpovede
{"ok":true}Chybové kódy
400 VALIDATION_ERROR — Pole `email` chýba alebo je prázdne.Overené správanie
Odpoveď je 200 `{"ok":true}`, bez ohľadu na to, či účet existuje; chýbajúce pole e-mail 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/refreshVymení platný refresh token za novú dvojicu prístupového tokenu a refresh tokenu.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.