POST/api/public/contact
Hupokea ombi kutoka kwenye fomu ya mawasiliano ya tovuti ya Zentor App na kulipeleka kwa timu ya Zentor.
Sehemu zinazohitajika ni `name` (herufi 2–120), `email` (anwani sahihi ya barua pepe), `message` (herufi 10–3000) na `consentGiven`, ambalo lazima liwekwe `true`. Kwa hiari, mnaweza kutuma `company`, `phone` na `topic`. Likifanikiwa, seva hujibu na `{"ok":true}` pamoja na ujumbe wa uthibitisho. Sehemu inayohitajika ikikosekana, isiyo sahihi au idhini ikikosekana, sehemu ya mwisho hujibu na 400 `VALIDATION_ERROR`; uga `details` huorodhesha makosa mahususi, ili mweze kuonyesha sehemu za kuingiza zilizohusika. Kila uwasilishaji uliofaulu huunda ombi jipya. Kwa hivyo zuieni kitufe cha kutuma hadi jibu lipatikane na msirudie ombi kiotomatiki. Kiwango cha juu maombi 10 kwa dakika 15 kwa kila anwani ya IP. Zaidi ya hayo sheria za ufikiaji za Zentor zinatumika (sheria za IP, nchi na kikoa cha barua pepe); maombi yaliyokataliwa hupokea 403.
Muhtasari
Mwito: POST /api/public/contact. Endpoint hii ni sehemu ya kundi la “Fomu za umma” la API ya Zentor App. Inafikika hadharani na haihitaji uthibitishaji. Mwito huu si idempotent: kila mwito uliofanikiwa huanzisha kitendo upya. Vigezo vya lazima: name (body), email (body), message (body), consentGiven (body). Vigezo vya hiari: company (body), phone (body), topic (body). Hali za hitilafu zilizoandikwa: 400 VALIDATION_ERROR. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Hapana
Vigezo
name(body, string, inahitajika)— Jina, herufi 2–120email(body, string, inahitajika)— Anwani sahihi ya barua pepemessage(body, string, inahitajika)— Ujumbe, herufi 10–3000company(body, string)— Kampuni (kwa hiari)phone(body, string)— Namba ya simu (kwa hiari)topic(body, string)— Mada ya swali (kwa hiari)consentGiven(body, boolean, inahitajika)— Idhini ya ulinzi wa data, lazima iwe `true`Mfano wa ombi (request)
{"name":"Max Mustermann","email":"max@example.com","message":"Ujumbe wako (angalau herufi 10).","consentGiven":true}Mfano wa jibu (response)
{"ok":true,"message":"Ombi lako limetumwa."}Misimbo ya hitilafu
400 VALIDATION_ERROR — Sehemu inayotakiwa inakosekana au ni batili, au idhini ya ulinzi wa data inakosekana. `details` ina ujumbe wa makosa binafsi.Tabia iliyoangaliwa
Taarifa kamili hutoa 200; sehemu zinazotakiwa zinazokosekana au idhini inayokosekana hutoa 400 `VALIDATION_ERROR`.
Fomu za umma
POST /api/public/consultationHupokea ombi la ushauri kutoka kwenye fomu ya tovuti ya Zentor App.POST /api/public/access-requestHutuma ombi la ufikiaji kwa kifurushi (Starter, Individuell au demo ya siku 14). Sharti ni anwani ya barua pepe iliyothibitishwa awali.POST /api/public/access-request/email/start-verificationHutuma msimbo wa nambari sita, unaofanya kazi dakika 10, kwenye anwani ya barua pepe iliyotolewa – hatua ya kwanza ya ombi la ufikiaji.POST /api/public/access-request/email/verifyHukagua msimbo uliotolewa kwa barua pepe na hutoa tokeni ya uthibitisho kwa ombi la ufikiaji linalofuata.GET /api/public/access-request/payment-statusHuonyesha njia za malipo zinazopatikana sasa (PayPal, Stripe) kwa ombi la ufikiaji.GET /api/public/access-request/paypal/configHutoa usanidi wa umma wa PayPal (unaotumika, hali, sarafu) kwa hatua ya malipo.POST /api/public/access-request/paypal/create-orderHuunda agizo la PayPal kwa kifurushi kilichochaguliwa.POST /api/public/access-request/paypal/capture-orderHukamilisha agizo lililoundwa awali na kuthibitishwa na mnunuzi katika PayPal Checkout (Capture). Kiasi hubainishwa na seva pekee.POST /api/public/access-request/stripe/create-checkoutHuunda kipindi cha malipo cha Stripe kwa kifurushi kilichochaguliwa.POST /api/public/activate-accountHuwezesha akaunti ya mtumiaji iliyoundwa upya na kuweka nenosiri la kwanza – linaloanzishwa kupitia kiungo kwenye barua pepe ya mwaliko.