POST/api/public/access-request

Hutuma ombi la ufikiaji kwa kifurushi (Starter, Individuell au demo ya siku 14). Sharti ni anwani ya barua pepe iliyothibitishwa awali.

Thibitisheni kwanza anwani ya barua pepe kupitia `POST /api/public/access-request/email/start-verification` na `POST /api/public/access-request/email/verify`. Kisha tumeni `name`, anwani ile ile ya barua pepe, kifurushi `package` (`starter`, `individual` au `demo_access`) na `verification_token` iliyopokelewa. Kwa hiari `company`, `phone`, `companyWebsite`, `paymentMethod` (`paypal`, `kreditkarte`, `rechnung`, `stripe_card` au `stripe_sepa`), `wish` (`trial`, `subscription` au `offer`; kwa ufikiaji wa demo huwa `trial` kila wakati) na `message`. Bila uthibitisho sahihi, seva hujibu na 400 `EMAIL_NOT_VERIFIED`. Sehemu zinazohitajika zisizokuwepo au thamani zisizo sahihi za kifurushi, njia ya malipo au hamu husababisha 400 `VALIDATION_ERROR`. Kila ombi lililofaulu huundwa kipya na kushughulikiwa na Zentor; kwa hivyo 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/access-request. 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), package (body). Vigezo vya hiari: company (body), phone (body), companyWebsite (body), paymentMethod (body), wish (body), message (body). Hali za hitilafu zilizoandikwa: 400 VALIDATION_ERROR, 400 EMAIL_NOT_VERIFIED. 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–120
email(body, string, inahitajika)— Anwani ya barua pepe iliyothibitishwa awali kupitia `/email/verify`
package(body, string, inahitajika)— Kifurushi: `starter`, `individual` au `demo_access`
company(body, string)— Kampuni, hadi herufi 160 (kwa hiari)
phone(body, string)— Namba ya simu, hadi herufi 40 (kwa hiari)
companyWebsite(body, string)— Tovuti ya kampuni, hadi herufi 200 (kwa hiari)
paymentMethod(body, string)— Njia ya malipo: `paypal`, `kreditkarte`, `rechnung`, `stripe_card` au `stripe_sepa` (kwa hiari)
wish(body, string)— Hitaji: `trial`, `subscription` au `offer`; kwa `demo_access` daima `trial` (kwa hiari)
message(body, string)— Ujumbe, hadi herufi 3000 (kwa hiari)

Mfano wa ombi (request)

{"name":"Juma Hamisi","email":"max@example.com","package":"demo_access"}

Mfano wa jibu (response)

{"ok":false,"error":"EMAIL_NOT_VERIFIED","message":"Bitte bestätigen Sie zuerst Ihre E-Mail-Adresse."}

Misimbo ya hitilafu

400 VALIDATION_ERROR — Sehemu inayotakiwa inakosekana, au kifurushi, njia ya malipo au hitaji ni batili.
400 EMAIL_NOT_VERIFIED — Anwani ya barua pepe haikuthibitishwa awali kupitia `/email/start-verification` na `/email/verify`, au `verification_token` inakosekana au ni batili.

Tabia iliyoangaliwa

Mwili tupu hutoa 400 `VALIDATION_ERROR`; data sahihi bila anwani ya barua pepe iliyothibitishwa hutoa 400 `EMAIL_NOT_VERIFIED`. Hali ya ufanisi hufuata mchakato ulioandikwa baada ya uthibitishaji wa barua pepe.

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/consultationHupokea ombi la ushauri kutoka kwenye fomu ya tovuti ya Zentor App.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.

Makala zinazohusiana

← Fomu za umma