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-maili
password(body, string, i detyrueshëm)— Fjalëkalim i ri

Shembull 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

Artikuj të lidhur

← Vërtetimi