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

Ithumela ikhodi yezinombolo eziyisithupha, esebenza imizuzu 10, ekhelini le-imeyili elinikeziwe – isinyathelo sokuqala sesicelo sokufinyelela.

Thumelani ikheli elidinga ukuqinisekiswa kunkambu `email`. Impendulo iqukethe `verification_id`, `expires_in_minutes` (10) nesibaluli `resend_cooldown_seconds` (60). Sebenzisani `verification_id` kanye nekheli elifanayo le-imeyili nekhodi etholiwe ku `POST /api/public/access-request/email/verify`. Ukuphinda ukuthumela kungenzeka kuphela ngemva kokwedlula kwesikhathi sokulinda; bonisani isikhathi esisele endaweni yenu yokusebenza. Uma umkhawulo wedlulwa, isiphetho siphendula ngo-429 `RATE_LIMIT_EXCEEDED`. Uma i-imeyili ingakwazi kulethwa, siphendula ngo-502 `MAIL_NOT_SENT`; hlolani ikheli bese nizama futhi kamuva.

Ukubuka konke

Ukubiza: POST /api/public/access-request/email/start-verification. Le endpoint ingeyeqembu elithi “Amafomu asesidlangalaleni” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: email (body). Izimo zamaphutha ezibhaliwe: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

Okuphezulu izicelo 10 kuma-15 wemizuzu ngekheli le-IP. Ngaphezu kwalokho kusebenza imithetho yokufinyelela ye-Zentor (imithetho ye-IP, yezwe neyedomeni le-imeyili); izicelo ezenqatshwayo zithola 403.

Umkhawulo wezinga (rate limit): 10 Anfragen pro 15 Minuten (IP-basiert)

I-idempotent: Cha

Amapharamitha

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

Isibonelo se-request

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

Isibonelo se-response

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

Amakhodi amaphutha

429 RATE_LIMIT_EXCEEDED — Izicelo eziningi kakhulu kusuka kweli kheli le-IP. Lindani ngaphambi kokucela ikhodi entsha.
502 MAIL_NOT_SENT — Ikhodi yokuqinisekisa ayikwazanga kuthunyelwa nge-imeyili.

Ukuziphatha okuhlolwe

Isicelo sinikeza 200 nge-`verification_id`, futhi ikhodi ithunyelwa nge-imeyili; izicelo eziphindwayo zinikeza 429 `RATE_LIMIT_EXCEEDED`.

Amafomu asesidlangalaleni

POST /api/public/contactYamukela isicelo esivela efomini lokuxhumana lewebhusayithi ye-Zentor App futhi isidlulisele ethimbeni le-Zentor.POST /api/public/consultationYamukela isicelo sokuyalwa esivela efomini lewebhusayithi ye-Zentor App.POST /api/public/access-requestFaka isicelo sokufinyelela sephakethe (Starter, Ngokwezifiso noma idemo yezinsuku 14). Isidingo esiphambili yikheli le-imeyili eliqinisekisiwe ngaphambili.POST /api/public/access-request/email/verifyIhlola ikhodi elethiwe nge-imeyili futhi ikhiphe ithokheni yokuqinisekisa yesicelo sokufinyelela esilandela.GET /api/public/access-request/payment-statusIkhombisa ukuthi yiziphi izindlela zokukhokha (PayPal, Stripe) ezitholakala njengamanje esicelo sokufinyelela.GET /api/public/access-request/paypal/configInikeza ukuhlelwa kwe-PayPal okuvulekile emphakathini (okusebenza, imodi, uhlobo lwemali) senyathelo lokukhokha.POST /api/public/access-request/paypal/create-orderIdala i-oda ye-PayPal yephakethe elikhethiwe.POST /api/public/access-request/paypal/capture-orderIqeda i-oda elidaliwe ngaphambili elikhululwa ngumthengi kuPayPal Checkout (Capture). Imali inqunywa yiseva kuphela.POST /api/public/access-request/stripe/create-checkoutIdala iseshini yokukhokha ye-Stripe yephakethe elikhethiwe.POST /api/public/activate-accountIvula i-akhawunti yomsebenzisi esanda kudalwa futhi ihlela iphasiwedi yokuqala – iqalwa ngesixhumanisi ku-imeyili yesimemo.

Izihloko ezihlobene

← Amafomu asesidlangalaleni