POST/api/auth/reset-password
Vendos një fjalëkalim të ri me token-in e rivendosjes nga e-maili.
Dërgoni `token`-in (nga lidhja e e-mailit të rivendosjes) dhe `password`-in e ri në trupin JSON. Hyrja për këtë nuk kërkohet. Fjalëkalimi duhet të plotësojë kërkesat minimale të Zentor App. Në rast suksesi, serveri përgjigjet me `{"ok":true}`; pastaj përdoruesi hyn me fjalëkalimin e ri. Një token i pavlefshëm, i skaduar ose tashmë i përdorur, si dhe një fjalëkalim që nuk i plotëson kërkesat minimale, çojnë në 400 `VALIDATION_ERROR`. Një token konsumohet pas përdorimit të suksesshëm; për një ndryshim të ri, nisni një proces të ri përmes `POST /api/auth/forgot-password`. Endpoint-i është i kufizuar në 10 kërkesa për 15 minuta për IP. Transmetoni token-in dhe fjalëkalimin vetëm në trupin e kërkesës mbi HTTPS, kurrë si parametra URL.
Përmbledhje
Thirrja: POST /api/auth/reset-password. Ky endpoint i përket grupit “Vërtetimi” të API-së së Zentor App. Është i aksesueshëm publikisht dhe nuk kërkon autentifikim. Thirrja nuk është idempotente: çdo thirrje e suksesshme e shkakton veprimin përsëri. Parametrat e detyrueshëm: token (body), password (body). Rastet e dokumentuara të gabimeve: 400 VALIDATION_ERROR. Përgjigjja shembull më poshtë tregon strukturën e një përgjigjeje të suksesshme në formatin JSON.
Autentifikimi dhe siguria
Nuk kërkohet autentifikim
Idempotent: Jo
Parametrat
token(body, string, i detyrueshëm)— Token-i i rivendosjes nga e-mailipassword(body, string, i detyrueshëm)— Fjalëkalim i riShembull request-i
{"token":"<Token nga email-i i rivendosjes>","password":"FjalekalimIRiISigurt!"}Shembull response-i
{"ok":true}Kodet e gabimeve
400 VALIDATION_ERROR — Token-i është i pavlefshëm, i skaduar ose tashmë i përdorur, ose fjalëkalimi nuk i plotëson kërkesat minimale.Sjellja e verifikuar
Një token i pavlefshëm kthen 400 `VALIDATION_ERROR`. Rasti i suksesit (200 `{"ok":true}`) përshkruhet në bazë të procesit të dokumentuar.
Vërtetimi
POST /api/auth/loginIdentifikon një përdorues me adresën e e-mailit ose emrin e përdoruesit dhe fjalëkalimin, dhe lëshon një token aksesi (JWT) dhe një refresh-token.POST /api/auth/refreshShkëmbon një refresh-token të vlefshëm me një çift të ri token aksesi dhe refresh-token.POST /api/auth/forgot-passwordNis rivendosjen e një fjalëkalimi: nëse ekziston një llogari me adresën e dhënë të e-mailit, ajo merr një e-mail me një lidhje për rivendosjen.POST /api/auth/sso/exchangeHapi i fundit i një identifikimi SSO (SAML/OIDC): shkëmbon kodin një-herësh nga ridrejtimi me një token aksesi dhe një refresh-token.