POST/api/public/access-request/email/start-verification

Ithumela ikhowudi yamanani amathandathu, esebenza imizuzu 10, kwidilesi ye-imeyile enikezelweyo – inyathelo lokuqala lesicelo sokufikelela.

Thumelani idilesi ekufuneka iqinisekiswe kwisixhumi `email`. Impendulo iqulethe `verification_id`, `expires_in_minutes` (10) nomlinganiselo `resend_cooldown_seconds` (60). Sebenzisani `verification_id` kunye nedilesi efanayo ye-imeyile kunye nekhowudi efunyenweyo ku `POST /api/public/access-request/email/verify`. Ukuthumela kwakhona kunokwenzeka kuphela emva kokuba ixesha lokulinda liphelile; bonisani ixesha eliseleyo kwijongano lenu. Ukuba umda ugqithisiwe, isiphelo siphendula nge-429 `RATE_LIMIT_EXCEEDED`. Ukuba i-imeyile ayinakuhanjiswa, siphendula nge-502 `MAIL_NOT_SENT`; jongani idilesi nize nizame kwakhona kamva.

Ushwankathelo

Ukubiza: POST /api/public/access-request/email/start-verification. Le endpoint yeyeqela elithi “Iifomu zikawonke-wonke” le-API ye-Zentor App. Ifikeleleka esidlangalaleni kwaye ayifuni kuqinisekiswa kwesazisi (authentication). Ukubiza ayisiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kwakhona. Iipharamitha ezinyanzelekileyo: email (body). Iimeko zeempazamo ezibhaliweyo: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.

Ukuqinisekiswa nokhuseleko

Akukho kuqinisekiswa kufunekayo

Ubuninzi izicelo 10 kwimizuzu 15 kwidilesi ye-IP. Ngaphezu koko kusebenza imithetho yokufikelela ye-Zentor (imithetho ye-IP, yelizwe neyedomeyini ye-imeyile); izicelo ezicekisiweyo zifumana 403.

Umda wesantya (Rate Limit): 10 Anfragen pro 15 Minuten (IP-basiert)

Idempotent: Hayi

Iiparamitha

email(body, string, kuyafuneka)— Idilesi ye-imeyile efuna ukuqinisekiswa

Umzekelo we-request

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

Umzekelo we-response

{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}

Iikhowudi zeempazamo

429 RATE_LIMIT_EXCEEDED — Izicelo ezininzi kakhulu kuvela kwiidilesi ye-IP. Linda ngaphambi kokucela ikhowudi entsha.
502 MAIL_NOT_SENT — Ikhowudi yokuqinisekisa ayikwazanga ukuthunyelwa nge-imeyile.

Ukuziphatha okujongwe

Isicelo sinikeza 200 nge-`verification_id`, kwaye ikhowudi ithunyelwa nge-imeyile; izicelo eziphindaphindiweyo zinikeza 429 `RATE_LIMIT_EXCEEDED`.

Iifomu zikawonke-wonke

POST /api/public/contactYamkela isicelo esivela kwifomu lonxibelelwano lewebhusayithi ye-Zentor App kwaye isidlulisele kwiqela le-Zentor.POST /api/public/consultationYamkela isicelo sengcebiso esivela kwifomu lewebhusayithi ye-Zentor App.POST /api/public/access-requestNgenisa isicelo sokufikelela kwipakethi (Starter, Elungiselelweyo okanye idemo yeentsuku 14). Imfuno engaphambili yidilesi ye-imeyile eqinisekisiweyo ngaphambili.POST /api/public/access-request/email/verifyIvavanya ikhowudi ehanjiswe nge-imeyile ize ikhuphe itoken yokuqinisekisa yesicelo sokufikelela esilandelayo.GET /api/public/access-request/payment-statusIbonisa ukuba zeziphi iindlela zokuhlawula (PayPal, Stripe) ezifumaneka ngoku kwisicelo sokufikelela.GET /api/public/access-request/paypal/configIbonelela ngokuqwalaselwa kwe-PayPal okuvulekileyo embuthweni (okusebenzayo, imowudi, uhlobo lwemali) kwinyathelo lokuhlawula.POST /api/public/access-request/paypal/create-orderIdala i-oda ye-PayPal yepakethi ekhethiweyo.POST /api/public/access-request/paypal/capture-orderIgqibezela i-oda eladalwayo ngaphambili lakhululwa ngumthengi kwi-PayPal Checkout (Capture). Imali imiselwa yiseva kuphela.POST /api/public/access-request/stripe/create-checkoutIdala iseshoni yokuhlawula ye-Stripe yepakethi elikhethiweyo.POST /api/public/activate-accountIvula i-akhawunti yomsebenzisi esandul' ukwenziwa kwaye isete iphasiwedi yokuqala – iqaliswa ngekhonkco kwi-imeyile yesimemo.

Amanqaku ahambelanayo

← Iifomu zikawonke-wonke