POST/api/auth/forgot-password

Iqalisa ukuthunyelwa kwe-imeyili yokusetha kutsha iphasiwedi, nxa kukhona i-akhawunti elaleli kheli. Iphendula ngamabomu ngendlela efanayo njalo (kakungeke kutholakale ukuthi i-akhawunti ikhona yini).

Ikhasi elithi “POST /api/auth/forgot-password — Ireferensi ye-API” liphathelene lengxenye yemisebenzi eqanjwe ku-URL. Okuqukethwe okukhona kwengezelelwa ngenqubo yangempela, izidingo kanye lemingcele eyaziwayo. IZentor kayilalo uhlelo lwama-API key abathuthukisi. Kudashibhodi kusetshenziswa ama-session JWT asebenza okwamahora alitshumi lambili kanye lama-refresh token asebenza okwensuku eziyisikhombisa; i-TOTP le-SSO kakusikho okuphoqelelweyo. Ama-widget embed token atshengiswa kanye kuphela ngombhalo ocacileyo njalo abophelwe kuma-origin avunyelweyo. Imibhalo emayelana le-`POST /api/auth/forgot-password` kumele ifundwe njengencazelo yezobuchwepheshe esemthethweni yale endpoint ethile. Okuqakathekileyo yindlela (method), i-path, ukuqinisekiswa kobuqotho (authentication), amasimu adingekayo, amaphutha angenzakala, lombuzo wokuthi ukubiza kabutsha kuveza yini umphumela ofananayo. Ngakho-ke lesi sigaba sosizo https://zentor-app.de/hilfe/api-referenz/auth/auth.forgot_password kasivumelekanga ukuba lamazwi okukhangisa ajwayelekileyo, kodwa kuphela izinyathelo zokuhlanganisa ezingalandelelwa kanye lezibonelo zezimpendulo ezilobufakazi. Ukuze kubizwe i-`/api/auth/forgot-password`, isicelo sakhiwa ngokuvumelana leRegistry. Imizila yomphakathi kayidingi i-API key yabathuthukisi ejwayelekileyo, ngoba iZentor kayinikezi uhlelo olunjalo lwama-key. Imizila ye-widget evikelweyo yona isebenzisa i-embed token etshengiswa kanye kuphela kanye lokuhlolwa kwe-origin. Isimo se-HTTP lokuqukethwe kwe-JSON kumele kuhlolwe ndawonye; insimu ye-`ok` iyodwa kayithathi indawo yokuphatha amaphutha. Lapho kuhlolwa i-`POST /api/auth/forgot-password` kumele kusetshenziswe amanani angaziwa (anonymized). Idatha yangempela yamakhasimende, ama-UUID okusebenza, ama-session token lezikhathi eziqondileyo akumelanga kube sezibonelweni zomphakathi. Umkhawulo owaziwayo wenkundla yonke yizicelo ezingu-2.000 phakathi kwemizuzu engu-15; umkhawulo othile ohlukileyo kawukaqinisekiswa. Ukubiza kwe-POST okungasi-idempotent kakumelanga kuphindwe ngokungaboni emva kokuqamuka kwenethiwekhi okungacacanga. Amaphutha okuhlanganisa ajwayelekileyo kulumzila avela ngenxa yamapharamitha adingekayo angekho, izinhlobo zedatha ezingalunganga, amakhodi okusebenza kanye aphelelwe yisikhathi, ama-origin angavunyelwanga kumbe irekhodi elingakasetshenziswa. Uhlelo kumele luphathe izimo ezinjalo ngokwehlukeneyo njalo lubhale umlayezo wephutha obuyiswa yi-endpoint, ngaphandle kokubhala okuqukethwe okuyimfihlo. Isicelo esiphumeleleyo siqinisekisa kuphela lesi sinyathelo sokucubungula, hatshi ngokuzenzakalela impumelelo elandelayo ye-imeyili, yokubhadala kumbe ye-SSO. Lokhu kuqakathekile ngqo ku-“POST /api/auth/forgot-password”. Ukuhlolwa kwezobuchwepheshe kwaleli khasi kumele kusekelwe ngokuqinileyo kuRegistry engaphansi kwe-`app/frontend/src/content/api-reference/` kanye lemizila ye-backend ehambelana layo. Amanothi okuhlolwa bukhoma kumele athi kuphela lokho okuhlolwe sibili. Ukuhlolwa okubi (negative test) kumbe ukufanisa ikhodi kakusibo ubufakazi obupheleleyo bempumelelo. Ngakho-ke ku-“POST /api/auth/forgot-password — Ireferensi ye-API” kumele kuhlukaniswe ngokucacileyo phakathi kwesakhiwo esibhaliweyo, ukuhlolwa okuzenzakalelayo kanye lokuziphatha bukhoma okubonwe ngokuqinisekileyo.

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

{"ok":true}