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

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

Thumelani ikheli elidinga ukuqinisekiswa emndeni `email`. Impendulo ilakho `verification_id`, `expires_in_minutes` (10) le-`resend_cooldown_seconds` (60). Sebenzisani `verification_id` kanye lekheli elifananayo le-imeyili lekhodi eftholakeleyo ku `POST /api/public/access-request/email/verify`. Ukuphinda ukuthumela kungenzakala kuphela ngemva kokwedlula kwesikhathi sokulinda; tshengisani isikhathi esiseleyo endaweni yenu yokusebenza. Nxa umkhawulo udlulwa, isiphetho siphendula nge-429 `RATE_LIMIT_EXCEEDED`. Nxa i-imeyili ingehluleki kulethwa, siphendula nge-502 `MAIL_NOT_SENT`; hlolani ikheli besezama futhi kamuva.

Isifinyezo

Ukubiza: POST /api/public/access-request/email/start-verification. Le endpoint ingeyeqembu elithi “Amafomu asedlangalaleni” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: email (body). Izimo zamaphutha ezibhaliweyo: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

Okuphezulu izicelo 10 kumaminithi 15 ngekheli le-IP. Phezu kwalokho kusebenza imithetho yokungena yeZentor (imithetho ye-IP, yelizwe leyedomeni ye-imeyili); izicelo ezalwa zithola 403.

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

I-idempotent: Hatshi

Amapharamitha

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

Isibonelo sesicelo (request)

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

Isibonelo sempendulo (response)

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

Amakhodi amaphutha

429 RATE_LIMIT_EXCEEDED — Izicelo ezinengi kakhulu kuvela kulekheli le-IP. Lindani lingakacela ikhodi entsha.
502 MAIL_NOT_SENT — Ikhodi yokuqinisekisa kayikwazanga ukuthunyelwa nge-imeyili.

Ukuziphatha okuhlolwe

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

Amafomu asedlangalaleni

POST /api/public/contactYamukela isicelo esivela efomini lokuxhumana lewebhusayithi yeZentor App njalo isidlulisele eqenjini leZentor.POST /api/public/consultationYamukela isicelo sokweluleka esivela efomini lewebhusayithi yeZentor App.POST /api/public/access-requestNgenisa isicelo sokungena kuphakheji (Starter, Okomuntu kumbe idemo yensuku 14). Isidingo esiqalayo yikheli le-imeyili eliqinisekisiweyo ngaphambili.POST /api/public/access-request/email/verifyIhlola ikhodi eletheyo nge-imeyili ikhiphe ithokheni yokuqinisekisa yesicelo sokungena esilandelayo.GET /api/public/access-request/payment-statusItshengisa ukuthi yiziphi izindlela zokukhokha (PayPal, Stripe) ezitholakala khathesi kuso sicelo sokungena.GET /api/public/access-request/paypal/configInikeza ukuhlelwa kwe-PayPal okuvulekileyo emphakathini (okusebenzayo, imodi, uhlobo lwemali) esinyathelo sokukhokha.POST /api/public/access-request/paypal/create-orderIdala i-oda ye-PayPal yephakheji ekhethiweyo.POST /api/public/access-request/paypal/capture-orderIqeda i-oda elidaliweyo ngaphambili elikhululwa ngumthengi kuPayPal Checkout (Capture). Imali inqunywa yiseva kuphela.POST /api/public/access-request/stripe/create-checkoutIdala iseshini yokukhokha ye-Stripe yephakheji elikhethiweyo.POST /api/public/activate-accountIvula i-akhawunti yomsebenzisi esandukwenziwa njalo ihlela iphasiwedi yokuqala – iqalwa ngesixhumanisi ku-imeyili lesimemo.

Izihloko ezihlobene

← Amafomu asedlangalaleni