POST/api/public/contact

Yamukela isicelo esivela efomini lokuxhumana lewebhusayithi ye-Zentor App futhi isidlulisele ethimbeni le-Zentor.

Imikhawulo edingekayo yi-`name` (2–120 izinhlamvu), `email` (ikheli le-imeyili elivumelekile), `message` (10–3000 izinhlamvu) nokuthi `consentGiven` kumele kusethelwe ku-`true`. Ngokukhethekile ningathumela `company`, `phone` ne-`topic`. Uma kuphumelele, iseva iphendula ngo-`{"ok":true}` nomlayezo wokuqinisekisa. Uma kukhona isimo esidingekayo esingekho, esingavumelekile noma imvume ingekho, isiphetho siphendula ngo-400 `VALIDATION_ERROR`; inkambu `details` ikhombisa amaphutha ngamunye, ukuze nikwazi ukumaka izinkambu zokufaka ezithintekayo. Ukuhambisa ngempumelelo ngakunye kudala isicelo esisha. Khawulani inkinobho yokuthumela kuze kube kuyimpendulo futhi ningawuphindi lo mbuzo ngokuzenzakalela. Okuphezulu izicelo eziyi-10 kuma-15 imizuzu nge-adilesi ye-IP. Ngaphezu kwalokho zisebenza imithetho yokufinyelela ye-Zentor (imithetho ye-IP, yezwe neyedomeni ye-imeyili); amabizo enqatshiwe athola u-403.

Ukubuka konke

Ukubiza: POST /api/public/contact. Le endpoint ingeyeqembu elithi “Amafomu asesidlangalaleni” le-API ye-Zentor App. Ifinyeleleka esidlangalaleni futhi ayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza akuyona i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kabusha. Amapharamitha ayimpoqo: name (body), email (body), message (body), consentGiven (body). Amapharamitha ongawakhetha: company (body), phone (body), topic (body). Izimo zamaphutha ezibhaliwe: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sibonisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubunikazi nokuvikeleka

Akudingeki ukuqinisekisa ubunikazi

I-idempotent: Cha

Amapharamitha

name(body, string, kuyadingeka)— Igama, izinhlamvu 2–120
email(body, string, kuyadingeka)— Ikheli le-imeyili elisebenzayo
message(body, string, kuyadingeka)— Umlayezo, izinhlamvu 10–3000
company(body, string)— Inkampani (okuzikhethela)
phone(body, string)— Inombolo yocingo (okuzikhethela)
topic(body, string)— Isihloko sombuzo (okuzikhethela)
consentGiven(body, boolean, kuyadingeka)— Imvume yokuvikelwa kwedatha, kumele ibe ngu-`true`

Isibonelo se-request

{"name":"Max Mustermann","email":"max@example.com","message":"Umlayezo wakho (okungenani izinhlamvu ezingu-10).","consentGiven":true}

Isibonelo se-response

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

Amakhodi amaphutha

400 VALIDATION_ERROR — Insimu edingekayo ayikho noma ayilungile, noma imvume yokuvikelwa kwedatha ayikho. `details` iqukethe imiyalezo yamaphutha ngayinye.

Ukuziphatha okuhlolwe

Imininingwane ephelele inikeza 200; izinsimu ezidingekayo ezingekho noma imvume engekho inikeza 400 `VALIDATION_ERROR`.

Amafomu asesidlangalaleni

POST /api/public/consultationYamukela isicelo sokuyalwa esivela efomini lewebhusayithi ye-Zentor App.POST /api/public/access-requestFaka isicelo sokufinyelela sephakethe (Starter, Ngokwezifiso noma idemo yezinsuku 14). Isidingo esiphambili yikheli le-imeyili eliqinisekisiwe ngaphambili.POST /api/public/access-request/email/start-verificationIthumela ikhodi yezinombolo eziyisithupha, esebenza imizuzu 10, ekhelini le-imeyili elinikeziwe – isinyathelo sokuqala sesicelo sokufinyelela.POST /api/public/access-request/email/verifyIhlola ikhodi elethiwe nge-imeyili futhi ikhiphe ithokheni yokuqinisekisa yesicelo sokufinyelela esilandela.GET /api/public/access-request/payment-statusIkhombisa ukuthi yiziphi izindlela zokukhokha (PayPal, Stripe) ezitholakala njengamanje esicelo sokufinyelela.GET /api/public/access-request/paypal/configInikeza ukuhlelwa kwe-PayPal okuvulekile emphakathini (okusebenza, imodi, uhlobo lwemali) senyathelo lokukhokha.POST /api/public/access-request/paypal/create-orderIdala i-oda ye-PayPal yephakethe elikhethiwe.POST /api/public/access-request/paypal/capture-orderIqeda i-oda elidaliwe ngaphambili elikhululwa ngumthengi kuPayPal Checkout (Capture). Imali inqunywa yiseva kuphela.POST /api/public/access-request/stripe/create-checkoutIdala iseshini yokukhokha ye-Stripe yephakethe elikhethiwe.POST /api/public/activate-accountIvula i-akhawunti yomsebenzisi esanda kudalwa futhi ihlela iphasiwedi yokuqala – iqalwa ngesixhumanisi ku-imeyili yesimemo.

Izihloko ezihlobene

← Amafomu asesidlangalaleni