网关号码还是长期号码：什么适合汤加项目？
先看任务的形态。如果你只需要看着一条短信验证码到达，用于注册测试、本地化检查或支持问题复现，那么 OTP Gateway 就是合适的产品。你会得到一个用于一次验证的 +676 号码，验证码出现在控制台和你的系统中，然后激活关闭。
如果你需要一个多月都留在账户上的号码，用于再次登录、接收找回码或运行客服线路，那是专用虚拟号码的工作。它们仅在美国和加拿大提供，每月 $1.95 起，支持入站和出站短信以及在浏览器中通话。
OTP Route 没有自助的汤加长期号码。需要的团队可以发邮件到 [email protected] 询问，但请了解能否提供取决于当地规定，也可能无法实现。关于这一取舍的更多内容，见临时号码与专用号码。
为什么有人要针对汤加号码测试注册流程？
汤加有庞大的海外侨民群体，其中许多人在新西兰、澳大利亚和美国，家人通过这些国家之间的即时通讯应用和汇款服务保持联系。服务太平洋社区的产品，例如汇款工具、社区平台和旅行服务，需要像接受 +64 号码一样放心地接受 +676 号码。
这让汤加成为 QA 中一个有用的边缘用例。汤加语和英语都是官方语言，国际应用发出的验证短信多数是英语，所以有意思的 bug 往往出在号码处理上，而不是消息措辞。为太平洋汇款通道构建金融科技注册的团队，正是出于这个原因，常常在回归测试集里加入汤加用例。
校验器应当如何处理 +676 号码？
汤加的国内号码比多数开发者心目中的欧洲或美国号码短得多，而且国际形式没有中继前缀。设有固定最小长度的校验代码，是这些号码被拒绝的最常见原因。
- 把每个号码都以 E.164 存储，即
+676加用户号码数字，绝不补位。 - 依靠最新的电话号码库，而不是从别的国家抄来的正则表达式。
- 确保你的短信发送器不会悄悄丢弃号码看起来太短的收件人。
- 在夹具集中保留一个汤加验证号码，这样日后的重构不会让这个 bug 卷土重来。
从 Gateway 下一个一次性 +676 订单，是用真实运营商送达的短信确认整条链路可用的廉价办法。
汤加线路覆盖哪些服务？
汤加线路目前列出超过 600 个服务。最新快照中的热门服务包括 Facebook、TikTok、Viber、WhatsApp、Instagram、Telegram、Google (Gmail & YouTube)、Snapchat、Microsoft & Outlook 和 Amazon。
随着容量在各线路之间移动，名单在一天中会变化。请把它当作参考，并在下单前通过控制台或价格端点查看实时可用性。
如何调用汤加 OTP API？
使用开发者控制台签发、以 or_live_ 开头的 Bearer 密钥向 https://otproute.com/api/v1 认证。汤加的国家 ID 是 to。
用 GET /api/v1/prices?country=to&service=<id> 查看价格和库存，然后用 POST /api/v1/activations 下单，请求体例如 {"service": "viber", "country": "to"}。响应会返回一个激活 ID 和一个 +676 号码。
要自动接收汤加短信 OTP 验证码，请为 activation.sms_received 和 activation.expired 注册 webhook。每个请求都包含 X-OTPRoute-Signature: t=<unix>,v1=<hex>；请用端点密钥对 <t>.<raw body> 重新计算 HMAC-SHA256，以恒定时间比较，并拒绝过期时间戳。小任务用轮询 GET /api/v1/activations/{id} 就可以，POST /api/v1/activations/{id}/cancel 则释放你不再需要的订单。每个账户的限制是每分钟 300 次请求、10 个密钥和 5 个 webhook 端点。请求和响应的细节见开发者文档。
汤加验证码很慢或缺失时可以怎么做？
在小型岛屿市场，线路供应偏少很正常，所以请在需要之前就构建好重试策略。
- 让 20 分钟窗口走完；若没有短信到达，订单会全额退款。
- 检查你测试的服务是否接受虚拟号码。有些不接受，任何线路都改变不了这一点。
- 再次尝试之前先等一等，不要连续下新订单。
- 如果测试针对的是一般的太平洋号码，可以试试附近的线路，如斐济或萨摩亚。
请记住，每个订单都必须遵守目标服务的条款和 OTP Route 的《可接受使用政策》。
计费和沙盒测试是如何运作的？
OTP Route 使用单一的预付美元钱包，按量付费，所以没有月费，也不需要选择套餐。可用银行卡或 USDT/USDC 稳定币充值，每次充值之后都会通过邮件发送 PDF 发票。仍在构建流程的开发者可以为开发账户申请沙盒模式，它会返回模拟号码和验证码，让 OTP 路由逻辑和 webhook 处理程序无需动用钱包即可测试。当前的每条验证码价格见定价页面。
常见问题
我不在汤加也能接收汤加验证码吗？
可以。从 OTP Gateway 订购一个 +676 号码，验证码会显示在你的控制台并发送到你的 webhook，无论你的团队身在何处。
短信验证 API 中汤加使用什么国家 ID？
ID 是 to，用于 GET /api/v1/prices 和 POST /api/v1/activations。
为什么我的表单会拒绝合法的汤加号码？
通常是针对更长号码编写的最小长度检查。请用持续维护的电话号码库校验，并以 E.164 存储号码。
有我可以保留的长期 +676 号码吗？
无法自助提供。长期专用号码仅在美国和加拿大提供；如需了解汤加的情况，请发邮件到 [email protected]。
如果汤加验证码没有到达，我的钱会怎样？
当 20 分钟窗口在没有短信的情况下关闭，或者你取消时，全部金额会自动退回钱包。
我能在 CI 中测试应用的汤加注册流程吗？
可以。每个环境使用一个 API 密钥，轮询或监听 webhook，并在构建流水线期间把开发账户切换到沙盒。
汤加验证短信以什么语言到达？
大多数国际应用发送英语，不过这取决于服务以及账户的语言设置。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。