POST/api/public/access-request
Faka isicelo sokufinyelela sephakethe (Starter, Ngokwezifiso noma idemo yezinsuku 14). Isidingo esiphambili yikheli le-imeyili eliqinisekisiwe ngaphambili.
Qinisekisani ikheli le-imeyili kuqala nge `POST /api/public/access-request/email/start-verification` ne `POST /api/public/access-request/email/verify`. Bese nithumela `name`, ikheli le-imeyili elifanayo, iphakethe `package` (`starter`, `individual` noma `demo_access`) nethokheni `verification_token` elitholiwe. Ngokukhethekile `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` noma `stripe_sepa`), `wish` (`trial`, `subscription` noma `offer`; ekufinyeleleni kwedemo kuhlala kuyi `trial`) ne-`message`. Ngaphandle kokuqinisekiswa okuvumelekile, iseva iphendula ngo-400 `EMAIL_NOT_VERIFIED`. Izinkambu ezidingekayo ezingekho noma amanani angavumelekile ephakethe, indlela yokukhokha noma isifiso kuholela ku-400 `VALIDATION_ERROR`. Isicelo esiphumelele ngasinye sakhiwa kabusha futhi sicutshungulwa yi-Zentor; ngakho ningaphindi ucingo ngokuzenzakalelayo. 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/access-request. 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), package (body). Amapharamitha ongawakhetha: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Izimo zamaphutha ezibhaliwe: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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 eliqinisekiswe ngaphambili nge-`/email/verify`package(body, string, kuyadingeka)— Iphakethe: `starter`, `individual` noma `demo_access`company(body, string)— Inkampani, okungenani izinhlamvu 160 (okuzikhethela)phone(body, string)— Inombolo yocingo, okungenani izinhlamvu 40 (okuzikhethela)companyWebsite(body, string)— Iwebhusayithi yenkampani, okungenani izinhlamvu 200 (okuzikhethela)paymentMethod(body, string)— Indlela yokukhokha: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` noma `stripe_sepa` (okuzikhethela)wish(body, string)— Isifiso: `trial`, `subscription` noma `offer`; ku-`demo_access` kuhlala ku-`trial` (okuzikhethela)message(body, string)— Umlayezo, okungenani izinhlamvu 3000 (okuzikhethela)Isibonelo se-request
{"name":"John Doe","email":"max@example.com","package":"demo_access"}Isibonelo se-response
{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Sicela uqale uqinisekise ikheli lakho le-imeyili."}Amakhodi amaphutha
400 VALIDATION_ERROR — Insimu edingekayo ayikho, noma iphakethe, indlela yokukhokha noma isifiso singalungile.400 EMAIL_NOT_VERIFIED — Ikheli le-imeyili alilonqa liqinisekiswe ngaphambili nge-`/email/start-verification` ne-`/email/verify`, noma i-`verification_token` ayikho noma ayilungile.Ukuziphatha okuhlolwe
Umzimba ongenalutho unikeza 400 `VALIDATION_ERROR`; idatha esebenzayo ngaphandle kwekheli le-imeyili eliqinisekisiwe inikeza 400 `EMAIL_NOT_VERIFIED`. Isimo sempumelelo silandela umhlahlandlela obhaliwe ngemva kokuqinisekiswa kwe-imeyili.
Amafomu asesidlangalaleni
POST /api/public/contactYamukela isicelo esivela efomini lokuxhumana lewebhusayithi ye-Zentor App futhi isidlulisele ethimbeni le-Zentor.POST /api/public/consultationYamukela isicelo sokuyalwa esivela efomini lewebhusayithi ye-Zentor App.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.