POST/api/public/contact

Yamukela isicelo esivela efomini lokuxhumana lewebhusayithi yeZentor App njalo isidlulisele eqenjini leZentor.

Izindawo ezidingakalayo yi-`name` (2–120 izinhlamvu), `email` (ikheli le-imeyili elisebenzayo), `message` (10–3000 izinhlamvu) le `consentGiven` okumele kusetwe ku-`true`. Ngokukhethekile lingathumela `company`, `phone` le-`topic`. Nxa kuphumelela, iseva iphendula nge-`{"ok":true}` njalo lomlayezo wokuqinisekisa. Nxa kukhona isimo esidingakalayo esingekho, esingasebenziyo kumbe imvume ingekho, isiphetho siphendula nge-400 `VALIDATION_ERROR`; inkambu `details` itshengisa amaphutha ngamunye, ukuze likwazi ukumaka izindawo zokufaka ezithintekayo. Ukuhambisa ngempumelelo kunye kugadzira isicelo esitsha. Valani inkinobho yokuthumela kuze kube yimpendulo njalo lingaphindi lumbuzo ngokuzenzakalela. Okuphezulu izicelo ezili-10 emizuzwini elili-15 nge-khelo le-IP. Phezu kwalokho isebenza imithetho yokungena yeZentor (imithetho ye-IP, yelizwe leyedomeni le-imeyili); amabizo enqabiweyo athola u-403.

Isifinyezo

Ukubiza: POST /api/public/contact. Le endpoint ingeyeqembu elithi “Amafomu asedlangalaleni” le-API ye-Zentor App. Ifinyeleleka emphakathini njalo kayidingi ukuqinisekiswa kobunikazi (authentication). Ukubiza kakusiyo i-idempotent: ukubiza ngakunye okuphumelelayo kuqalisa isenzo kutsha. Amapharamitha adingekayo: name (body), email (body), message (body), consentGiven (body). Amapharamitha okukhetha: company (body), phone (body), topic (body). Izimo zamaphutha ezibhaliweyo: 400 VALIDATION_ERROR. Isibonelo sempendulo ngezansi sitshengisa ukwakheka kwempendulo ephumelelayo ngefomethi ye-JSON.

Ukuqinisekisa ubuwena lokuvikeleka

Kakudingeki ukuqinisekisa ubuwena

I-idempotent: Hatshi

Amapharamitha

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

Isibonelo sesicelo (request)

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

Isibonelo sempendulo (response)

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

Amakhodi amaphutha

400 VALIDATION_ERROR — Insimu edingakalayo kayikho kumbe kayilunganga, kumbe imvumo yokuvikelwa kwedatha kayikho. `details` ilomumbiko wamaphutha ngayinye.

Ukuziphatha okuhlolwe

Imininingwane epheleleyo inikeza 200; izinsimu ezidingakalayo kayikho kumbe imvumo kayikho inikeza 400 `VALIDATION_ERROR`.

Amafomu asedlangalaleni

POST /api/public/consultationYamukela isicelo sokweluleka esivela efomini lewebhusayithi yeZentor App.POST /api/public/access-requestNgenisa isicelo sokungena kuphakheji (Starter, Okomuntu kumbe idemo yensuku 14). Isidingo esiqalayo yikheli le-imeyili eliqinisekisiweyo ngaphambili.POST /api/public/access-request/email/start-verificationIthumela ikhodi yezinombolo eziyisithupha, esebenza imizuzu 10, ekhelini le-imeyili eliphiweyo – isinyathelo sokuqala sesicelo sokungena.POST /api/public/access-request/email/verifyIhlola ikhodi eletheyo nge-imeyili ikhiphe ithokheni yokuqinisekisa yesicelo sokungena esilandelayo.GET /api/public/access-request/payment-statusItshengisa ukuthi yiziphi izindlela zokukhokha (PayPal, Stripe) ezitholakala khathesi kuso sicelo sokungena.GET /api/public/access-request/paypal/configInikeza ukuhlelwa kwe-PayPal okuvulekileyo emphakathini (okusebenzayo, imodi, uhlobo lwemali) esinyathelo sokukhokha.POST /api/public/access-request/paypal/create-orderIdala i-oda ye-PayPal yephakheji ekhethiweyo.POST /api/public/access-request/paypal/capture-orderIqeda i-oda elidaliweyo ngaphambili elikhululwa ngumthengi kuPayPal Checkout (Capture). Imali inqunywa yiseva kuphela.POST /api/public/access-request/stripe/create-checkoutIdala iseshini yokukhokha ye-Stripe yephakheji elikhethiweyo.POST /api/public/activate-accountIvula i-akhawunti yomsebenzisi esandukwenziwa njalo ihlela iphasiwedi yokuqala – iqalwa ngesixhumanisi ku-imeyili lesimemo.

Izihloko ezihlobene

← Amafomu asedlangalaleni