POST/api/auth/forgot-password

Iqala ukusetha kabusha iphasiwedi: uma i-akhawunti enekheli le-imeyili elinikeziwe ikhona, ithola i-imeyili enesixhumanisi sokusetha kabusha.

Thumela ikheli le-imeyili le-akhawunti ensimini ethi `email`. Impendulo ethi `{"ok":true}` ihlala ifanayo ngamabomu – kungakhathaliseki ukuthi i-akhawunti ikhona noma cha – ukuze lesi sixhumi singavunyelwe kuthole amakheli abhalisiwe. Iphasiwedi entsha isethwa ngemva kwalokho ngethokheni evela ku-imeyili nge`POST /api/auth/reset-password`. Uma insimu ethi `email` ishoda noma ingenalutho, isixhumi siphendula ngo-400 `VALIDATION_ERROR`. Ukuvikela ukuhlukunyezwa, inani lezicelo ngekheli ngalinye le-IP likhawulelwe (429 `RATE_LIMIT_EXCEEDED`).

Ukubuka konke

Ukubiza: POST /api/auth/forgot-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kaningi ngemininingwane efanayo kubuyisa umphumela ofanayo. Amapharamitha ayimpoqo: email (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: Yebo

Amapharamitha

email(body, string, kuyadingeka)— Ikheli le-imeyili le-akhawunti

Isibonelo se-request

{"email":"user@example.com"}

Isibonelo se-response

{"ok":true}

Amakhodi amaphutha

400 VALIDATION_ERROR — Insimu ethi `email` ishoda noma ingenalutho.

Ukuziphatha okuhlolwe

Impendulo iyi-200 `{"ok":true}`, kungakhathaliseki ukuthi i-akhawunti ikhona noma cha; insimu ye-imeyili eshodayo inikeza i-400 `VALIDATION_ERROR`.

Ukuqinisekiswa

Izihloko ezihlobene

← Ukuqinisekiswa