POST/api/public/consultation
Yamukela isicelo sokuyalwa esivela efomini lewebhusayithi ye-Zentor App.
Imikhawulo edingekayo yi-`name` (2–120 izinhlamvu), `email` (ikheli le-imeyili elivumelekile) nokuthi `consentGiven` kumele kusethelwe ku-`true`. Ngokukhethekile ningathumela `company`, `phone` ne-`message`. Uma kuphumelele, iseva iphendula ngo-`{"ok":true}` nomlayezo wokuqinisekisa; ithimba le-Zentor liyothintana nani ngemva kwalokho. Uma kukhona isimo esidingekayo esingekho, esingavumelekile noma imvume ingekho, isiphetho siphendula ngo-400 `VALIDATION_ERROR`. Ukufonelwa ngempumelelo ngakunye kudala isicelo esisha; ngakho-ke ukufonelwa akuyi-idempotent. 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/consultation. 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), consentGiven (body). Amapharamitha ongawakhetha: company (body), message (body), phone (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 elisebenzayocompany(body, string)— Inkampani (okuzikhethela)message(body, string)— Umlayezo (okuzikhethela)phone(body, string)— Inombolo yocingo (okuzikhethela)consentGiven(body, boolean, kuyadingeka)— Imvume yokuvikelwa kwedatha, kumele ibe ngu-`true`Isibonelo se-request
{"name":"Max Mustermann","email":"max@example.com","company":"Musterfirma","message":"Indaba","consentGiven":true}Isibonelo se-response
{"ok":true,"message":"Isicelo sakho sokweluleka sithunyelwe. Sizoxhumana nawe maduze."}Amakhodi amaphutha
400 VALIDATION_ERROR — Insimu edingekayo ayikho noma ayilungile, noma imvume ayikho.Ukuziphatha okuhlolwe
Imininingwane ephelele inikeza 200; imininingwane engekho noma engalungile inikeza 400 `VALIDATION_ERROR`.
Amafomu asesidlangalaleni
POST /api/public/contactYamukela isicelo esivela efomini lokuxhumana lewebhusayithi ye-Zentor App futhi isidlulisele ethimbeni le-Zentor.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.