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–120email(body, string, kuyadingeka)— Ikheli le-imeyili elisebenzayomessage(body, string, kuyadingeka)— Umlayezo, izinhlamvu 10–3000company(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.