POST/api/auth/reset-password

Isetha iphasiwedi entsha ngethokheni ye-reset evela ku-imeyili yokusetha kabusha.

Thumela `token` (evela esixhumanisini se-imeyili yokusetha kabusha) ne`password` entsha kumzimba we-JSON. Ukungena akudingekile. Iphasiwedi kufanele ihambisane nezidingo eziphansi ze-Zentor App. Uma kuphumelele, iseva iphendula ngo`{"ok":true}`; emva kwalokho umsebenzisi angena nephasiwedi entsha. Ithokheni engasebenzi, ephelelwe isikhathi noma eyasivele isetshenzisiwe, kanye nephasiwedi engahambisani nezidingo eziphansi, kuholela ku-400 `VALIDATION_ERROR`. Ithokheni iqedwa ngemva kokusetshenziswa ngempumelelo; ukuze nishintshe futhi, qala inqubo entsha nge`POST /api/auth/forgot-password`. Isixhumi sikhawulelwe ezicelweni ezingu-10 ngemizuzu engu-15 ngekheli le-IP. Thumela ithokheni nephasiwedi kuphela emzimbeni wesicelo nge-HTTPS, neze njengamapharamitha e-URL.

Ukubuka konke

Ukubiza: POST /api/auth/reset-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: token (body), password (body). Izimo zamaphutha ezibhaliwe: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

I-idempotent: Cha

Amapharamitha

token(body, string, kuyadingeka)— Ithokheni ye-reset evela ku-imeyili
password(body, string, kuyadingeka)— Iphasiwedi entsha

Isibonelo se-request

{"token":"<Ithokheni evela ku-imeyili yokusetha kabusha>","password":"IphasiwediEntshaEphephile!"}

Isibonelo se-response

{"ok":true}

Amakhodi amaphutha

400 VALIDATION_ERROR — Ithokheni ayisebenzi, iphelelwe isikhathi noma yasivele isetshenzisiwe, noma iphasiwedi ayihambisani nezidingo eziphansi.

Ukuziphatha okuhlolwe

Ithokheni engasebenzi inikeza i-400 `VALIDATION_ERROR`. Isimo sempumelelo (i-200 `{"ok":true}`) sichazwe ngokwenqubo ebhalwe phansi.

Ukuqinisekiswa

Izihloko ezihlobene

← Ukuqinisekiswa