卡塔尔 OTP API 的调用顺序是怎样的？
所有接口都位于 https://otproute.com/api/v1 之下，使用以 or_live_ 开头的 Bearer 密钥认证。你最多可以持有 10 个密钥，所以建议给 CI、预发布环境和运维脚本分别配置密钥，这样吊销其中一个不会影响其他的。一次完整的 +974 激活最多需要四次调用：
GET /api/v1/prices?country=qa&service=<id>返回实时价格，并告诉你该服务的线路当前是否开放。POST /api/v1/activations，请求体为{"service": "<id>", "country": "qa"}，用于预留一个卡塔尔号码并返回激活 id。GET /api/v1/activations/{id}是轮询调用：它显示卡塔尔订单的进度，验证码送达后也会包含在其中。POST /api/v1/activations/{id}/cancel提前结束订单，并把金额退回钱包。
另有两个辅助接口：GET /api/v1/services 把名称映射为服务 id，GET /api/v1/balance 让流水线在余额耗尽前停下。请把每个账户的流量保持在每分钟 300 次请求以内。开发者概览 汇总了各参考页面。
Webhook 处理程序应如何对待卡塔尔的激活事件？
轮询可行，但 Webhook 能让你的测试运行器在事情发生的瞬间作出反应。最多可注册五个端点，并订阅 activation.sms_received、activation.expired 和 activation.cancelled；第一个携带验证码，另外两个告诉运行器不必再等待。
每个请求都包含格式为 t=<unix>,v1=<hex> 的 X-OTPRoute-Signature。把被签名的字符串重建为时间戳、一个点号和原始请求体，用端点密钥计算 HMAC-SHA256，并以恒定时间比较。时间戳过期的一律拒绝。由于重试可能多次投递同一事件，请记录激活 id 并忽略重复项。参考实现可阅读 基于 Webhook 的 OTP 捕获。
哪些服务可以把验证码路由到 +974 号码？
卡塔尔属于覆盖较广的线路，最新快照中有超过 1,600 个服务。常用条目包括 WhatsApp、Google (Gmail & YouTube)、Microsoft & Outlook、Telegram、Instagram、Facebook、LinkedIn、Snapchat、TikTok、Uber、Airbnb、ChatGPT (OpenAI)、Claude 和 Discord。
库存在一天中会变化，所以请把快照当作参考，把 API 的回答当作准绳。少数服务会拒绝虚拟号码；这种情况下订单只会到期，款项随之退回。上述每个名称都是其所有者的商标，不暗示任何隶属关系。
在测试数据中规范化卡塔尔号码
卡塔尔号码在 +974 之后有八位数字，没有国内长途前缀，所以把本地号码转换为国际格式时无需去掉任何内容。测试数据请使用 E.164 格式（+974 加八位数字），并清理用户输入中带有的 00974、空格，或沿用其他国家习惯而多出的前导零。
阿拉伯语是官方语言，而英语在商务中使用广泛，当地人口中外籍居民占比很高。因此验证短信会以发送服务为该账户选定的语言到达，常见的是英语或阿拉伯语。请检查你的提取逻辑能否在两种文字中找到验证码，并确认阿拉伯语界面在从右到左的布局下，OTP 输入框仍然可用。
团队测试卡塔尔线路的场景包括：在海湾合作委员会（GCC）地区上线、为阿拉伯语用户本地化消费类应用、在多哈开展酒店或物流业务，或在不使用员工个人号码的情况下验证区域性企业账户。CI 测试指南 展示了如何把这些检查接入自动化运行。
改用控制台进行卡塔尔验证
并非每次验证都需要脚本。在控制台打开 OTP Gateway，选择卡塔尔和服务，查看显示的价格并确认。把 +974 号码复制到应用中，请求发送短信，验证码就会出现在订单上。20 分钟窗口从你下单的那一刻开始计时，只有验证码到达才需要付费。
收不到验证码：排查清单
- 等够时间了吗？ 在判定失败之前，让激活跑完完整的窗口期。
- 服务接受虚拟号码吗？ 有些服务会屏蔽它们，反复尝试也改变不了。
- 重试策略合理吗？ 退避后稍后重试，或为同一服务换一条线路。在紧凑的循环里重复下单只会浪费你的速率限制，很少有帮助。
- 处理程序正常吗？ 如果签名校验失败，或端点返回错误，请轮询
GET /api/v1/activations/{id}，看看验证码是否已送达而你的 Webhook 没有接到。
激活无论因到期还是取消而没有收到短信，都会全额退款。
有卡塔尔的长期号码吗？用量如何计费？
卡塔尔没有自助购买的长期号码。专属虚拟号码（你自己的线路，支持收发短信、Webhook 转发和浏览器通话）仅在美国和加拿大提供，每月 $1.95 起。若有针对卡塔尔的需求，请发邮件至 [email protected]；能否实现取决于当地规定。
卡塔尔的用量从一个预付美元钱包中扣除，没有任何月费。可通过银行卡或 USDT/USDC 充值，每次充值都可领取 PDF 发票；如果想用模拟号码测试集成，可为开发账户申请沙盒模式。+974 号码仅限用于你自己的产品和合法的企业账户，请遵守各服务的条款，并遵循 OTP Route 的《可接受使用政策》。
常见问题
如何在自动化测试中接收卡塔尔短信 OTP 验证码？
用国家 qa 创建激活，把返回的号码填入被测应用，然后等待 activation.sms_received Webhook。如果你的测试运行器无法接收入站请求，OTP Route 也支持轮询激活状态。
没有卡塔尔 SIM 卡，也能用 +974 号码做测试吗？
可以。OTP Gateway 提供用于接收一条验证码的卡塔尔验证号码，所以无需任何本地 SIM 卡或设备，就能测试注册或登录流程。
下单前如何查看卡塔尔的价格？
调用 GET /api/v1/prices?country=qa&service=<id>，或在控制台中查看。价格每条验证码 $0.20 起，因服务而异。
失败的卡塔尔激活会扣费吗？
不会。只有验证码到达才会计费；已过期或已取消的激活会自动退回钱包。
为什么要用卡塔尔号码测试，而不是邻国的号码？
请选择与账户真实市场相符的国家。如果你的产品在卡塔尔上线，+974 号码能验证你的客户将遇到的国家代码处理、语言和 OTP 路由，详见 OTP 的国家路由。
开发账户可以在没有钱包余额的情况下运行吗？
可以。应要求，开发账户可以切换为沙盒，它会返回模拟的号码和验证码，用于端到端测试。
我能保留一个卡塔尔号码用于反复登录吗？
不能自助购买，因为专属号码仅限美国和加拿大。如果想咨询卡塔尔的长期号码，请发邮件至 [email protected]。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。