获取 +967 验证码的最短 API 路径是什么？
让你的客户端指向 https://otproute.com/api/v1，使用来自开发者控制台的 Bearer 密钥；密钥带有 or_live_ 前缀。也门的国家 ID 为 ye。
- 用
GET /api/v1/prices?country=ye&service=<id>获取价格；响应会告诉你验证码的费用以及线路是否开放。 - 创建订单：
POST /api/v1/activations，请求体为{"service": "whatsapp", "country": "ye"}。你会得到一个激活 ID 和 +967 号码。 - 把号码输入或注入你自己应用的验证步骤。
- 从
GET /api/v1/activations/{id}或 Webhook 事件中取回验证码。 - 用
POST /api/v1/activations/{id}/cancel释放未完成的订单。
GET /api/v1/services 和 GET /api/v1/countries 很少变化，所以可以缓存一天。在批处理之前调用 GET /api/v1/balance，可以让任务在余额不足时提前停止。每分钟 300 次请求的限制按账户计算，最多可签发 10 个密钥。关于这套也门 OTP API 流程的完整示例，请参阅集成指南。
如何验证也门激活的 Webhook 推送？
在开发者控制台注册一个 HTTPS 端点（一个账户可以有五个），并订阅 activation.sms_received，同时订阅 activation.expired 和 activation.cancelled，让你的任务知道何时可以停止等待。
签名校验遵循同一个流程。把 X-OTPRoute-Signature 拆分为 t 和 v1，使用端点密钥对字符串 <t>.<raw body> 计算 HMAC-SHA256，并用恒定时间函数将结果与 v1 比较。如果时间戳比你的容差更旧，则拒绝该请求。由于推送可能被重试，请让处理程序保持幂等：保存激活 ID 并忽略重复项。使用 HMAC 保护 OTP Webhook 涵盖了时钟漂移等边缘情况。
我的解析器应该如何处理阿拉伯语消息？
阿拉伯语是也门的官方语言，所以许多服务会以阿拉伯语发送周围的文字。这对测试自己消息的人有实际影响：阿拉伯文字需要 UCS-2 编码，这会把一条短信分段限制为 70 个字符，而从右到左的文本可能改变验证码在通知中出现的位置。有些模板把数字放在句子前面，有些放在后面。
请把提取步骤写成：无论周围是什么词，都找出那一串数字。同样明智的做法是，把阿拉伯-印度数字（٠ 到 ٩）规范化为 ASCII 数字，以防发送方使用它们。团队在为阿拉伯语用户本地化应用、支持生活在海湾地区的也门客户，或确认区域客服账户仍能完成验证时，会运行这些检查。OTP Route 返回的是收到时的原始消息，所以你在测试中解析的，就是用户会收到的内容。
也门电话号码如何格式化？
国家代码是 +967。手机号在其后有九位数字，并以 7 开头，格式为 +967 7XX XXX XXX。如果用户在前面输入了国内的 0，请在保存之前去掉它，并存储不含分隔符的 E.164 字符串；本地格式只应出现在界面中。
对 +967 测试号码有用的校验用例：
- 用户从国家列表中选择 +967，然后又再次键入包含区号的完整号码。
- 号码是从通讯录名片中复制过来、带有阿拉伯-印度数字的粘贴内容。
- 数字分组之间出现空格或短横线。
这些情形都应得到同一个存储值，从而保证查询和去重可靠。
目前哪些服务可路由到 +967 号码？
也门在 OTP Gateway 上有超过 1,700 项服务。实时快照中的常用条目包括 WhatsApp、Telegram、imo、Facebook、Instagram、TikTok、Snapchat、Google (Gmail & YouTube)、X (Twitter)、Microsoft & Outlook、Signal、Discord 和 Amazon。
可用性是个动态目标，所以请把测试套件构建为先询问 API。工程以外的人员可以在控制台完成同样的工作：使用邮箱验证码或 Google 登录开通账户，充值，选择也门和服务，然后把也门验证号码复制到应用中，并在激活页面上等待验证码。
也门验证码为什么会没到，怎么解决？
每个订单的有效期为 20 分钟。如果没有短信到达，或者你在到达之前取消，全部金额会自动退回你的钱包；你只为到达的验证码付费。
常见原因和应对：
- 服务当时较慢：放弃之前让窗口跑完。
- 服务拒绝虚拟号码：查看其政策；退款会处理这次失败的尝试。
- 线路繁忙：稍后再试，或改用另一条服务线路。
- 脚本一旦落空就立即重新下单：加入退避，避免对线路反复冲击。
这些号码只能用于你自己的产品和合法账户，请遵守各服务的条款，并遵守 OTP Route 的《可接受使用政策》。
我能长期持有也门号码吗？如何计费？
无法自助开通。专属虚拟号码仅在美国和加拿大提供，可即时购买，每月 $1.95 起。需要长期使用 +967 号码的团队可以发邮件至 [email protected]；是否能够提供取决于当地规定，也永远没有把握。
OTP Route 钱包以美元预付，没有订阅，也没有套餐。可用银行卡或 USDT/USDC 充值，每次充值都会通过电子邮件发送 PDF 发票。当前费率请查看价格；如果需要为集成工作提供模拟的号码和验证码，可为开发账户申请沙盒。
常见问题
我能在没有本地 SIM 卡的情况下，用也门号码测试阿拉伯语注册流程吗？
可以。订购国家为 ye 的 OTP Gateway 号码，输入到你自己的应用中，然后在控制台或通过 Webhook 读取阿拉伯语或英语的消息。
+967 验证码的价格是多少？
每个验证码 $0.20 起，因服务而异；GET /api/v1/prices 会返回实时价格。从未到达的验证码会在 20 分钟窗口结束时退款。
如果短信是从右到左书写的，如何提取验证码？
搜索数字序列，而不是句子模式，并先把阿拉伯-印度数字转换为 ASCII 数字。无论验证码位于文本的哪一侧，这样都有效。
+967 号码归我长期所有吗？
不是，OTP Gateway 号码只覆盖一次验证。长期号码是美国和加拿大的产品；关于也门，请发邮件给客服咨询。
我能在不花钱包余额的情况下集成吗？
可以，为开发账户申请沙盒。它会返回模拟的号码和验证码，足以测试轮询、Webhook 和错误处理。
API 对也门使用什么国家 ID？
是 ye。在价格查询和 POST /api/v1/activations 的 JSON 请求体中传入它。
为什么有服务拒绝了我的也门号码？
有些服务不接受虚拟号码。取消激活或让它自行过期，款项会自动退回你的钱包。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。