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 msimbo
code(body, string, inahitajika)— Msimbo wa tarakimu sita kutoka barua pepe

Mfano 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.

Makala zinazohusiana

← Fomu za umma