POST/api/public/access-request

Ngenisa isicelo sokufikelela kwipakethi (Starter, Elungiselelweyo okanye idemo yeentsuku 14). Imfuno engaphambili yidilesi ye-imeyile eqinisekisiweyo ngaphambili.

Qinisekisani kuqala idilesi ye-imeyile nge-`POST /api/public/access-request/email/start-verification` kunye ne-`POST /api/public/access-request/email/verify`. Emva koko nithumele `name`, idilesi ye-imeyile efanayo, ipakethi `package` (`starter`, `individual` okanye `demo_access`) kunye netoken `verification_token` efunyenweyo. Ngokukhethekile `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` okanye `stripe_sepa`), `wish` (`trial`, `subscription` okanye `offer`; kufikelelo lwedemo kuhlala kuyi `trial`) kunye ne-`message`. Ngaphandle kwenqinisekiso esebenzayo, iseva iphendula nge-400 `EMAIL_NOT_VERIFIED`. Imihlathi eyimfuneko engekho okanye amaxabiso angasebenziyo epakethi, indlela yokuhlawula okanye umnqweno aholela ku-400 `VALIDATION_ERROR`. Isicelo ngasinye esiphumeleleyo senziwa kwakhona kwaye siqhutywa yi-Zentor; ngoko musa kuphinda uqhagamshelwano ngokuzenzekelayo. Ubuninzi bezicelo eziyi-10 kwimizuzu eyi-15 nge-dilesi ye-IP. Ngaphezulu koko kusebenza imithetho yokufikelela ye-Zentor (imithetho ye-IP, yelizwe neyedomeni ye-imeyile); amabizo achithwayo afumana u-403.

Ushwankathelo

Ukubiza: POST /api/public/access-request. 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: name (body), email (body), package (body). Iipharamitha ozikhethayo: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Iimeko zeempazamo ezibhaliweyo: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. Impendulo engumzekelo engezantsi ibonisa ulwakhiwo lwempendulo ephumelelayo ngefomathi ye-JSON.

Ukuqinisekiswa nokhuseleko

Akukho kuqinisekiswa kufunekayo

Idempotent: Hayi

Iiparamitha

name(body, string, kuyafuneka)— Igama, iinqaku 2–120
email(body, string, kuyafuneka)— Idilesi ye-imeyile eqinisekiswe ngaphambili nge-`/email/verify`
package(body, string, kuyafuneka)— Ipakethi: `starter`, `individual` okanye `demo_access`
company(body, string)— Inkampani, ubuncinane iinqaku 160 (okukhethwayo)
phone(body, string)— Inombolo yefowuni, ubuncinane iinqaku 40 (okukhethwayo)
companyWebsite(body, string)— Iwebhusayithi yenkampani, ubuncinane iinqaku 200 (okukhethwayo)
paymentMethod(body, string)— Indlela yokuhlawula: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` okanye `stripe_sepa` (okukhethwayo)
wish(body, string)— Umnqweno: `trial`, `subscription` okanye `offer`; kwi-`demo_access` kuhlala kwi-`trial` (okukhethwayo)
message(body, string)— Umyalezo, ubuncinane iinqaku 3000 (okukhethwayo)

Umzekelo we-request

{"name":"John Doe","email":"max@example.com","package":"demo_access"}

Umzekelo we-response

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Nceda uqale uqinisekise idilesi yakho ye-imeyile."}

Iikhowudi zeempazamo

400 VALIDATION_ERROR — Intsimi efunekayo ayikho, okanye ipakethi, indlela yokuhlawula okanye umnqweno awulunganga.
400 EMAIL_NOT_VERIFIED — Idilesi ye-imeyile ayiqinisekiswanga ngaphambili nge-`/email/start-verification` kunye ne-`/email/verify`, okanye i-`verification_token` ayikho okanye ayilunganga.

Ukuziphatha okujongwe

Umzimba ongento unikeza 400 `VALIDATION_ERROR`; idatha esebenzayo ngaphandle kwedilesi ye-imeyile eqinisekisiweyo inikeza 400 `EMAIL_NOT_VERIFIED`. Imeko yempumelelo ilandela inkqubo ebhaliweyo emva kokuqinisekiswa kwe-imeyile.

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-request/email/start-verificationIthumela ikhowudi yamanani amathandathu, esebenza imizuzu 10, kwidilesi ye-imeyile enikezelweyo – inyathelo lokuqala lesicelo sokufikelela.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