Qatar OTP API: Mga Webhook, Polling, at +974 Test Number

Ano ang hitsura ng pagkakasunod-sunod ng mga tawag sa Qatar OTP API?

Lahat ay nasa ilalim ng https://otproute.com/api/v1, na naka-authenticate gamit ang Bearer key na nagsisimula sa or_live_. Puwede kang magkaroon ng hanggang 10 key, kaya bigyan ng magkakahiwalay na key ang CI, staging, at operations script para ma-revoke ang isa nang hindi naaapektuhan ang iba. Ang kumpletong +974 activation ay nangangailangan ng hanggang apat na tawag:

1. Ibinabalik ng GET /api/v1/prices?country=qa&service=<id> ang live na presyo at sinasabi sa iyo kung bukas ang route para sa serbisyong iyon ngayon.
2. Ang POST /api/v1/activations na may {"service": "<id>", "country": "qa"} ay nagre-reserve ng numero ng Qatar at nagbabalik ng activation id.
3. Ang GET /api/v1/activations/{id} ang polling call: ipinapakita nito kung nasaan na ang order sa Qatar at kasama ang code pagkatapos ng delivery.
4. Tinatapos ng POST /api/v1/activations/{id}/cancel ang order nang maaga at ibinabalik ang halaga sa wallet.

Dalawang katulong ang kumukumpleto sa larawan: ang GET /api/v1/services ay nagmamapa ng mga pangalan sa service id, at ang GET /api/v1/balance ay nagpapahintulot sa pipeline na huminto bago maubusan. Panatilihin ang trapiko sa ilalim ng 300 request kada minuto kada account. Nakalap sa developer overview ang mga reference page.

Paano dapat harapin ng webhook handler ang mga activation event ng Qatar?

Gumagana ang polling, pero hinahayaan ng webhook ang iyong test runner na tumugon sa mismong sandali na may nangyari. Mag-register ng hanggang limang endpoint at mag-subscribe sa activation.sms_received, activation.expired, at activation.cancelled; dala ng una ang code, at sinasabi naman ng dalawa pa sa runner mo na tumigil na sa paghihintay.

Bawat request ay may kasamang X-OTPRoute-Signature sa anyong t=<unix>,v1=<hex>. Buuin muli ang nilagdaang string bilang timestamp, tuldok, at raw request body, kalkulahin ang HMAC-SHA256 gamit ang secret ng endpoint, at ihambing sa constant time. Tanggihan ang anumang luma na ang timestamp. Dahil maaaring maghatid nang higit sa isang beses ng parehong event ang mga retry, itabi ang activation id at huwag pansinin ang mga ulit. Para sa reference implementation, basahin ang webhook-based OTP capture.

Aling mga serbisyo ang makapaghahatid ng code sa isang +974 na numero?

Isa ang Qatar sa mas malalawak na route, na may mahigit 1,600 serbisyo sa pinakabagong snapshot. Kabilang sa mga sikat na entry ang WhatsApp, Google (Gmail & YouTube), Microsoft & Outlook, Telegram, Instagram, Facebook, LinkedIn, Snapchat, TikTok, Uber, Airbnb, ChatGPT (OpenAI), Claude, at Discord.

Nagbabago ang imbentaryo sa buong araw, kaya ituring ang snapshot bilang gabay lamang at ang sagot ng API bilang katotohanan. May ilang serbisyong tumatanggi sa mga virtual number; kapag ganoon, mag-e-expire lang ang order at babalik ang pera. Ang bawat pangalan sa itaas ay trademark ng may-ari nito, at walang ipinahihiwatig na kaugnayan.

Pag-normalise ng mga numero ng Qatar sa mga test fixture

Walong digit ang mga numero ng Qatar pagkatapos ng +974 at walang trunk prefix, kaya wala kang aalisin kapag kino-convert ang lokal na numero sa international form. Itabi ang mga fixture sa E.164 (+974 kasama ang walong digit), at linisin ang input na tinatype ng mga user na may 00974, espasyo, o nalalabing zero sa unahan na dala ng nakasanayan sa ibang bansa.

Ang Arabic ang opisyal na wika, habang malawakang ginagamit ang English sa negosyo at ng populasyong malaki ang bahagi ng mga expatriate. Kaya ang mga verification text ay dumarating sa anumang wikang piliin ng serbisyong nagpapadala para sa account, kadalasan ay English o Arabic. Tiyaking nahahanap ng extraction logic mo ang code sa parehong script at nananatiling magagamit ang OTP input sa right-to-left na layout kapag Arabic ang UI.

Nagte-test ang mga team sa route ng Qatar kapag naglulunsad sa GCC, nila-localise ang consumer app para sa mga nagsasalita ng Arabic, nagpapatakbo ng hospitality o logistics na operasyon sa Doha, o nagve-verify ng regional na business account nang hindi inilalagay ang personal na numero ng empleyado. Ipinapakita ng gabay sa CI testing kung paano isasama ang mga check na ito sa mga automated na run.

Pagpapatakbo ng check sa Qatar mula sa dashboard

Hindi lahat ng verification ay nangangailangan ng script. Sa dashboard, buksan ang OTP Gateway, piliin ang Qatar at ang serbisyo, suriin ang ipinapakitang presyo, at kumpirmahin. Kopyahin ang +974 na numero sa app, humiling ng SMS, at lalabas ang code sa order. Nagsisimulang bilangin ang 20 minutong window mula sa sandaling i-place mo ang order, at magbabayad ka lamang kung dumating ang code.

Mga code na hindi dumating: listahan sa pag-debug

• Naghintay ka ba nang sapat? Hayaang tumakbo ang activation sa buong window nito bago ituring na pumalya.
• Tinatanggap ba ang virtual number? Hinaharang ito ng ilang serbisyo, at hindi ito mababago ng paulit-ulit na pagsubok.
• Maayos ba ang retry policy? Magpahinga at subukan muli mamaya, o lumipat sa ibang route para sa parehong serbisyo. Ang pag-order nang paulit-ulit sa mabilis na loop ay nauubos lang ang rate limit mo at bihirang makatulong.
• Malusog ba ang handler? Kung pumapalya ang signature check o nagbabalik ng error ang endpoint, mag-poll sa GET /api/v1/activations/{id} para makita kung naihatid ang code habang hindi ito nahuli ng webhook mo.

Ang activation na nagtatapos nang walang SMS, sa expiry man o sa cancellation, ay buong ire-refund.

May pangmatagalang linya ba sa Qatar, at paano sinisingil ang paggamit?

Walang self-serve na pangmatagalang numero para sa Qatar. Ang Dedicated Virtual Numbers (sarili mong linya na may inbound at outbound SMS, webhook forwarding, at browser calling) ay iniaalok lamang sa United States at Canada, mula $1.95/month. Para sa pangangailangang partikular sa Qatar, mag-email sa [email protected]; ang mga lokal na patakaran ang magtatakda kung ano ang posible.

Ang paggamit sa Qatar ay kumukuha sa iisang prepaid na USD wallet, at walang buwanang singil. Mag-top up gamit ang card o USDT/USDC, kunin ang PDF invoice para sa bawat top-up, at humiling ng sandbox mode sa development account kung gusto mong i-test ang integrasyon gamit ang mga simulated na numero. Gamitin ang mga +974 na numero para lamang sa sarili mong mga produkto at lehitimong business account, igalang ang mga tuntunin ng bawat serbisyo, at sundin ang Acceptable Use Policy ng OTP Route.

Mga madalas itanong

Paano ako makakatanggap ng Qatar SMS OTP code sa isang automated test?

Gumawa ng activation na may country qa, ilagay ang ibinalik na numero sa app na sinusubukan, at hintayin ang activation.sms_received na webhook. Sinusuportahan din ng OTP Route ang polling ng activation kung hindi makatanggap ng inbound request ang test runner mo.

Puwede ba akong gumamit ng +974 na numero para sa testing nang walang SIM ng Qatar?

Oo. Nagbibigay ang OTP Gateway ng verification number ng Qatar para sa isang code, kaya masusubukan mo ang mga sign-up o login flow nang walang lokal na SIM o device.

Paano ko titingnan ang mga presyo para sa Qatar bago mag-order?

Tawagan ang GET /api/v1/prices?country=qa&service=<id> o tumingin sa dashboard. Nagsisimula ang mga rate sa $0.20 kada code at nag-iiba ayon sa serbisyo.

Sisingilin ba ako para sa mga activation sa Qatar na pumalya?

Hindi. Sisingilin ka lamang kapag dumating ang code; ang mga activation na nag-expire o na-cancel ay awtomatikong ire-refund sa wallet.

Bakit magte-test gamit ang numero ng Qatar sa halip na isa mula sa karatig na bansa?

Piliin ang bansang tumutugma sa tunay na merkado ng account. Kung naglulunsad ang produkto mo sa Qatar, ang isang +974 na numero ang susubok sa eksaktong paghawak ng country code, wika, at OTP routing na makikita ng mga customer mo, gaya ng ipinaliwanag sa country routing para sa OTP.

Puwede bang tumakbo ang development account nang walang pondo sa wallet?

Oo. Kapag hiniling, puwedeng ilipat sa sandbox ang isang development account, na nagbabalik ng mga simulated na numero at code para sa end-to-end na testing.

Puwede ko bang panatilihin ang numero ng Qatar para sa paulit-ulit na pag-login?

Hindi sa self-serve na paraan, dahil limitado sa US at Canada ang mga dedicated na linya. Mag-email sa [email protected] kung gusto mong magtanong tungkol sa pangmatagalang linya sa Qatar.

Ang mga pangalan ng serbisyo ay trademark ng kani-kanilang may-ari. Walang kaugnayan ang OTP Route sa kanila. Gamitin nang legal ang mga number at sundin ang mga tuntunin ng bawat serbisyo at ang aming Acceptable Use Policy.