POST/api/public/contact

Yamkela isicelo esivela kwifomu lonxibelelwano lewebhusayithi ye-Zentor App kwaye isidlulisele kwiqela le-Zentor.

Iinkcukacha eziyimfuneko zezi: `name` (2–120 ovelatye), `email` (idilesi ye-imeyile esebenzayo), `message` (10–3000 ovelatye) kunye no-`consentGiven` ekufuneka usetwe ku-`true`. Ngokukhethekile ninganithumela `company`, `phone` kunye ne-`topic`. Xa impumelelo, iseva iphendula nge-`{"ok":true}` kunye nomyalezo wokuqinisekisa. Ukuba kukho umhlathi oyimfuneko ongekho, ongasebenziyo okanye imvume ingekho, isiphelo siphendula nge-400 `VALIDATION_ERROR`; umhlathi `details` ubonisa impazamo nganye, ukuze nikwazi ukuphawula iinkqubo zokufaka ezichaphazelekayo. Ukungenisa ngempumelelo ngakokunye kudala isicelo esitsha. Valani iqhosha lokuthumela de kube yimpendulo kwaye ningaliphindi 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/contact. 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), message (body), consentGiven (body). Iipharamitha ozikhethayo: company (body), phone (body), topic (body). Iimeko zeempazamo ezibhaliweyo: 400 VALIDATION_ERROR. 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 esebenzayo
message(body, string, kuyafuneka)— Umyalezo, iinqaku 10–3000
company(body, string)— Inkampani (okukhethwayo)
phone(body, string)— Inombolo yefowuni (okukhethwayo)
topic(body, string)— Umxholo wombuzo (okukhethwayo)
consentGiven(body, boolean, kuyafuneka)— Imvume yokhuselo lwedatha, kufuneka ibe ngu-`true`

Umzekelo we-request

{"name":"Max Mustermann","email":"max@example.com","message":"Umyalezo wakho (ubuncinci abalinganiswa abali-10).","consentGiven":true}

Umzekelo we-response

{"ok":true,"message":"Isicelo sakho sithunyelwe."}

Iikhowudi zeempazamo

400 VALIDATION_ERROR — Intsimi efunekayo ayikho okanye ayilunganga, okanye imvume yokhuselo lwedatha ayikho. `details` iqulethe imiyalezo yeempazamo ngayinye.

Ukuziphatha okujongwe

Iinkcukacha ezipheleleyo zinikeza 200; iintsimi ezifunekayo ezingekho okanye imvume engekho zinikeza 400 `VALIDATION_ERROR`.

Iifomu zikawonke-wonke

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/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