POST/api/public/access-request/email/verify
Hukagua msimbo uliotolewa kwa barua pepe na hutoa tokeni ya uthibitisho kwa ombi la ufikiaji linalofuata.
Tumeni `verification_id` (kutoka `start-verification`), anwani ile ile ya barua pepe na msimbo wa nambari sita `code`. Likifanikiwa, jibu lina `verified: true` na `verification_token`, mnayotuma pamoja wakati wa kuwasilisha ombi la ufikiaji kupitia `POST /api/public/access-request`. Msimbo usiosahihi au uliomaliza muda, `verification_id` isiyolingana au anwani ya barua pepe inayotofautiana husababisha 400 `VERIFY_FAILED`. Katika hali hiyo ombeni msimbo mpya. Tokeni hii inatumika kwa anwani hii ya barua pepe pekee na haipaswi kuonekana kwenye URL au kumbukumbu. Kiwango cha juu maombi 10 kwa dakika 15 kwa kila anwani ya IP.
Muhtasari
Mwito: POST /api/public/access-request/email/verify. 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: verification_id (body), email (body), code (body). Hali za hitilafu zilizoandikwa: 400 VERIFY_FAILED. Jibu la mfano hapa chini linaonyesha muundo wa jibu lililofanikiwa katika umbizo la JSON.
Uthibitishaji na ulinzi
Hakuna uthibitishaji unaohitajika
Idempotent: Hapana
Vigezo
verification_id(body, string, inahitajika)— `verification_id` kutoka `start-verification`email(body, string, inahitajika)— Anwani ile ile ya barua pepe kama ya kuomba msimbocode(body, string, inahitajika)— Msimbo wa tarakimu sita kutoka barua pepeMfano wa ombi (request)
{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}Mfano wa jibu (response)
{"ok":true,"verified":true,"verification_token":"<Tokeni kwa ajili ya ombi la ufikiaji linalofuata>"}Misimbo ya hitilafu
400 VERIFY_FAILED — Msimbo, `verification_id` au anwani ya barua pepe ni batili, au msimbo umepitwa na wakati.Tabia iliyoangaliwa
Msimbo usio sahihi hutoa 400 `VERIFY_FAILED`. Hali ya ufanisi inalingana na uthibitishaji wa barua pepe wa kiunda bidhaa.
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/start-verificationHutuma msimbo wa nambari sita, unaofanya kazi dakika 10, kwenye anwani ya barua pepe iliyotolewa – hatua ya kwanza ya ombi la ufikiaji.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.