POST/api/public/consultation
Hupokea ombi la ushauri kutoka kwenye fomu ya tovuti ya Zentor App.
Sehemu zinazohitajika ni `name` (herufi 2–120), `email` (anwani sahihi ya barua pepe) na `consentGiven`, ambalo lazima liwekwe `true`. Kwa hiari, mnaweza kutuma `company`, `phone` na `message`. Likifanikiwa, seva hujibu na `{"ok":true}` pamoja na ujumbe wa uthibitisho; timu ya Zentor itawasiliana nanyi baadaye. Sehemu inayohitajika ikikosekana, isiyo sahihi au idhini ikikosekana, sehemu ya mwisho hujibu na 400 `VALIDATION_ERROR`. Kila ombi lililofaulu huunda ombi jipya; kwa hivyo ombi hili si idempotent. 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/consultation. 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), consentGiven (body). Vigezo vya hiari: company (body), message (body), phone (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 pepecompany(body, string)— Kampuni (kwa hiari)message(body, string)— Ujumbe (kwa hiari)phone(body, string)— Namba ya simu (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","company":"Musterfirma","message":"Hitaji","consentGiven":true}Mfano wa jibu (response)
{"ok":true,"message":"Ihre Beratungsanfrage wurde übermittelt. Wir melden uns in Kürze bei Ihnen."}Misimbo ya hitilafu
400 VALIDATION_ERROR — Sehemu inayotakiwa inakosekana au ni batili, au idhini inakosekana.Tabia iliyoangaliwa
Taarifa kamili hutoa 200; taarifa zinazokosekana au batili hutoa 400 `VALIDATION_ERROR`.
Fomu za umma
POST /api/public/contactHupokea ombi kutoka kwenye fomu ya mawasiliano ya tovuti ya Zentor App na kulipeleka kwa timu ya Zentor.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.