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–120email(body, string, kuyafuneka)— Idilesi ye-imeyile esebenzayomessage(body, string, kuyafuneka)— Umyalezo, iinqaku 10–3000company(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.