POST/api/auth/forgot-password

Iqala ukusetha kutsha iphasiwedi: nxa i-akhawunti elekheli le-imeyili elinikeziweyo ikhona, ithola i-imeyili elesixhumanisi sokusetha kutsha.

Thumelani ikheli le-imeyili le-akhawunti ensimini ethi `email`. Impendulo ethi `{"ok":true}` ihlala ifanayo ngabomu – loba i-akhawunti ikhona kumbe hatshi – ukuthi lesihlanganiso singakwazi ukuthola amakheli abhalisiweyo. Iphasiwedi entsha isethwa ngemva kwalokho ngethokheni evela ku-imeyili nge`POST /api/auth/reset-password`. Nxa insimu ethi `email` iswelekile kumbe ingaselutho, isihlanganiso siphendula ngo-400 `VALIDATION_ERROR`. Ukuvikela ukuhlukunyezwa, inani lezicelo ngekheli ngalinye le-IP likhawulelwe (429 `RATE_LIMIT_EXCEEDED`).

Isifinyezo

Ukubiza: POST /api/auth/forgot-password. Le endpoint ingeyeqembu elithi “Ukuqinisekiswa” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kuyi-idempotent: ukubiza kanengi ngemininingwane efananayo kubuyisela umphumela ofananayo. Amapharamitha adingekayo: email (body). Izimo zamaphutha ezibhaliweyo: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

I-idempotent: Yebo

Amapharamitha

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

Isibonelo sesicelo (request)

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

Isibonelo sempendulo (response)

{"ok":true}

Amakhodi amaphutha

400 VALIDATION_ERROR — Insimu ethi `email` iswelekile kumbe ingaselutho.

Ukuziphatha okuhlolwe

Impendulo yi-200 `{"ok":true}`, kungelandaba ukuthi i-akhawunti ikhona kumbe hatshi; insimu ye-imeyili eswelekileyo inikeza i-400 `VALIDATION_ERROR`.

Ukuqinisekiswa

Izihloko ezihlobene

← Ukuqinisekiswa