POST/api/public/access-request
Ngenisa isicelo sokungena kuphakheji (Starter, Okomuntu kumbe idemo yensuku 14). Isidingo esiqalayo yikheli le-imeyili eliqinisekisiweyo ngaphambili.
Qinisekisani ikheli le-imeyili kuqala nge-`POST /api/public/access-request/email/start-verification` le-`POST /api/public/access-request/email/verify`. Besithumela `name`, ikheli le-imeyili elifananayo, iphakheji `package` (`starter`, `individual` kumbe `demo_access`) le-token `verification_token` eliftholakeleyo. Ngokukhethekile `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` kumbe `stripe_sepa`), `wish` (`trial`, `subscription` kumbe `offer`; ekungeneni kwedemo kuhlala kuyi `trial`) le-`message`. Ngaphandle kokuqinisekiswa okusebenzayo, iseva iphendula nge-400 `EMAIL_NOT_VERIFIED`. Izindawo ezidingakalayo ezingekho kumbe amanani angasebenziyo ephakheji, indlela yokukhokha kumbe isifiso kuholela ku-400 `VALIDATION_ERROR`. Isicelo esiphumeleleyo ngasinye sakhiwa kutsha njalo sicubungulwa yiZentor; ngakho lingaphindi ucingo 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/access-request. 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), package (body). Amapharamitha okukhetha: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Izimo zamaphutha ezibhaliweyo: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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 eliqinisekiswe ngaphambili nge-`/email/verify`package(body, string, kuyadingeka)— Iphakheji: `starter`, `individual` kumbe `demo_access`company(body, string)— Inkampani, okungedlula izinhlamvu 160 (okuzikhethelayo)phone(body, string)— Inombolo yocingo, okungedlula izinhlamvu 40 (okuzikhethelayo)companyWebsite(body, string)— Iwebhusayithi yenkampani, okungedlula izinhlamvu 200 (okuzikhethelayo)paymentMethod(body, string)— Indlela yokukhokha: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` kumbe `stripe_sepa` (okuzikhethelayo)wish(body, string)— Isifiso: `trial`, `subscription` kumbe `offer`; ku-`demo_access` kuhlala ku-`trial` (okuzikhethelayo)message(body, string)— Umlayezo, okungedlula izinhlamvu 3000 (okuzikhethelayo)Isibonelo sesicelo (request)
{"name":"John Doe","email":"max@example.com","package":"demo_access"}Isibonelo sempendulo (response)
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Sicela uqinisekise kuqala ikheli lakho le-imeyili."}Amakhodi amaphutha
400 VALIDATION_ERROR — Insimu edingakalayo kayikho, kumbe iphakheji, indlela yokukhokha kumbe isifiso kakulungile.400 EMAIL_NOT_VERIFIED — Ikheli le-imeyili kalizange liqinisekiswe ngaphambili nge-`/email/start-verification` lo-`/email/verify`, kumbe i-`verification_token` kayikho kumbe kayilunganga.Ukuziphatha okuhlolwe
Umzimba ongelalutho unikeza 400 `VALIDATION_ERROR`; idatha esebenzayo ngaphandle kwekheli le-imeyili eliqinisekisiweyo inikeza 400 `EMAIL_NOT_VERIFIED`. Isimo sempumelelo silandela umhlahlandlela obhaliweyo ngemva kokuqinisekiswa kwe-imeyili.
Amafomu asedlangalaleni
POST /api/public/contactYamukela isicelo esivela efomini lokuxhumana lewebhusayithi yeZentor App njalo isidlulisele eqenjini leZentor.POST /api/public/consultationYamukela isicelo sokweluleka esivela efomini lewebhusayithi yeZentor App.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.