POST/api/public/consultation

Yamkela isicelo sengcebiso esivela kwifomu lewebhusayithi ye-Zentor App.

Iinkcukacha eziyimfuneko zezi: `name` (2–120 ovelatye), `email` (idilesi ye-imeyile esebenzayo) kunye no-`consentGiven` ekufuneka usetwe ku-`true`. Ngokukhethekile ninganithumela `company`, `phone` kunye ne-`message`. Xa impumelelo, iseva iphendula nge-`{"ok":true}` kunye nomyalezo wokuqinisekisa; iqela le-Zentor lizakunixhumana emva koko. Ukuba kukho umhlathi oyimfuneko ongekho, ongasebenziyo okanye imvume ingekho, isiphelo siphendula nge-400 `VALIDATION_ERROR`. Uqhagamshelwano ngempumelelo ngakokunye kudala isicelo esitsha; ngoko ke uqhagamshelwano aluyi-idempotent. 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/consultation. 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), consentGiven (body). Iipharamitha ozikhethayo: company (body), message (body), phone (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
company(body, string)— Inkampani (okukhethwayo)
message(body, string)— Umyalezo (okukhethwayo)
phone(body, string)— Inombolo yefowuni (okukhethwayo)
consentGiven(body, boolean, kuyafuneka)— Imvume yokhuselo lwedatha, kufuneka ibe ngu-`true`

Umzekelo we-request

{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Isicelo","consentGiven":true}

Umzekelo we-response

{"ok":true,"message":"Isicelo sakho seengcebiso sithunyelwe. Siza kunxibelelana nawe kungekudala."}

Iikhowudi zeempazamo

400 VALIDATION_ERROR — Intsimi efunekayo ayikho okanye ayilunganga, okanye imvume ayikho.

Ukuziphatha okujongwe

Iinkcukacha ezipheleleyo zinikeza 200; iinkcukacha ezingekho okanye ezingalunganga zinikeza 400 `VALIDATION_ERROR`.

Iifomu zikawonke-wonke

POST /api/public/contactYamkela isicelo esivela kwifomu lonxibelelwano lewebhusayithi ye-Zentor App kwaye isidlulisele kwiqela le-Zentor.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