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