POST/api/public/access-request/email/start-verification
Hutuma msimbo wa nambari sita, unaofanya kazi dakika 10, kwenye anwani ya barua pepe iliyotolewa – hatua ya kwanza ya ombi la ufikiaji.
Tumeni anwani inayohitaji kuthibitishwa katika uga `email`. Jibu lina `verification_id`, `expires_in_minutes` (10) na `resend_cooldown_seconds` (60). Tumieni `verification_id` pamoja na anwani ile ile ya barua pepe na msimbo ulioupokea katika `POST /api/public/access-request/email/verify`. Kutuma tena ni rahisi tu baada ya muda wa kusubiri kupita; onyesheni muda uliosalia kwenye kiolesura chenu. Kiwango kikizidishwa, sehemu ya mwisho hujibu na 429 `RATE_LIMIT_EXCEEDED`. Barua pepe isipowasilishwa, hujibu na 502 `MAIL_NOT_SENT`; kagueni anwani na jaribuni tena baadaye.
Muhtasari
Mwito: POST /api/public/access-request/email/start-verification. 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: email (body). Hali za hitilafu zilizoandikwa: 429 RATE_LIMIT_EXCEEDED, 502 MAIL_NOT_SENT. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Kiwango cha juu maombi 10 kwa dakika 15 kwa 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.
Kikomo cha kasi: 10 Anfragen pro 15 Minuten (IP-basiert)
Idempotent: Hapana
Vigezo
email(body, string, inahitajika)— Anwani ya barua pepe inayopaswa kuthibitishwaMfano wa ombi (request)
{"email":"max@example.com"}Mfano wa jibu (response)
{"ok":true,"verification_id":"<UUID>","expires_in_minutes":10,"resend_cooldown_seconds":60}Misimbo ya hitilafu
429 RATE_LIMIT_EXCEEDED — Maombi mengi sana kutoka anwani hii ya IP. Subirini kabla ya kuomba msimbo mpya.502 MAIL_NOT_SENT — Msimbo wa uthibitishaji haukuweza kutumwa kwa barua pepe.Tabia iliyoangaliwa
Ombi hutoa 200 na `verification_id`, na msimbo hutumwa kwa barua pepe; maombi yanayorudiwa hutoa 429 `RATE_LIMIT_EXCEEDED`.
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-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/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.