第一次下 Twitch 订单前的预检清单
请求号码之前，先过一遍这份清单：
- 用途合法：你在测试自己的集成、扩展，或者运营你的组织所拥有的频道账号。
- API 密钥就绪：来自开发者控制台的 Bearer 密钥（前缀
or_live_）。 - 已注册 webhook 端点，其密钥保存在服务端。
- 国家已选定，与账号的受众或测试用例相符。
- 钱包已充值，或已申请沙盒用于演练。
- 已确认长期需求：如果账号之后还要再次验证，请先看最后一节。
Twitch 会在哪里要求提供手机号？
Twitch 可在注册时用手机号替代邮箱，也可用于确认账号、找回密码，以及开启双重验证时。直播、管理或运行扩展的频道通常会启用两步登录，这使得一个可联系的号码成为日常访问的一部分，而不只是一次性的步骤。
对 QA 团队来说，这意味着两种不同的测试形态。注册或确认测试只需要一条验证码，用完即止，这正是 OTP Gateway 所提供的。而带两步验证的登录测试则需要在同一号码上反复收取验证码，这就要用长期线路。下单前请先确定你测试的是哪一种，因为它决定你需要的产品。
Twitch 号码应该来自哪个国家？
Twitch 在 197 个国家有线路，包括美国、加拿大、英国、德国、巴西、日本、墨西哥、法国、西班牙、波兰、韩国、土耳其、菲律宾和澳大利亚。
让号码与账号所属的市场保持一致。针对巴西频道的本地化测试，用巴西号码更贴近真实情况，而区域风控检查可能把不匹配视为异常。国家路由指南解释了其中的原因。
分步说明：通过 API 获取 Twitch OTP
- 用
GET /api/v1/services确认服务 id 是twitch，并从GET /api/v1/countries选择国家 id。 - 查询费用：
GET /api/v1/prices?country=<id>&service=twitch。 - 下单：
POST /api/v1/activations，请求体为{"service": "twitch", "country": "<id>"}。 - 在 Twitch 的手机号字段中填入返回的号码。
- 等待
activation.sms_received，或轮询GET /api/v1/activations/{id}。 - 提交验证码，并结束你的测试。
基础 URL 为 https://otproute.com/api/v1，每个账号每分钟 300 次请求。在 CI 任务中，把第 3 到 6 步包装进同一个测试 fixture，并在其 teardown 中取消激活，这样中途中止的运行就不会留下悬而未决的订单；CI 流水线中的短信 OTP 测试展示了这种做法。
webhook 处理程序应该怎么写？
每次投递都包含 X-OTPRoute-Signature: t=<unix>,v1=<hex>。用端点密钥对 <t>.<raw body> 重新计算 HMAC-SHA256，用恒定时间比较，并拒绝过期的时间戳。以激活 id 作为键让处理程序保持幂等，这样重试的投递就不会把同一个 Twitch 验证码提交两次。如果你的端点无法访问，轮询激活是合理的后备方案。参见基于 webhook 的 OTP 捕获。
面向社区和频道管理员的控制台步骤
并非每个人都需要 API。在控制台中打开 OTP Gateway，选择 Twitch 和国家，查看显示的价格并下单。把号码填入 Twitch；验证码送达后会显示在订单旁边。这适合为单个品牌账号做设置的频道管理员。它还能让主播的个人手机号不出现在公司名下的资料中，在人员变动、需要干净地交接访问权限时，这一点很重要。
故障排查：没有验证码、号码被拒、窗口过期
- 什么都没收到：让 20 分钟窗口走完。过期或取消都会自动退还全部金额。
- Twitch 拒绝了号码：Twitch 可能拒绝虚拟号码；稍后换一条国家线路再试。
- 反复失败：先暂停，不要在短时间内循环重新下单，并确认你填入的是完整的国际号码。
- 提交了错误的验证码：确保你的处理程序读取的是最新的激活，而不是缓存的旧记录。
- 集成缺陷：申请沙盒，用模拟验证码重放流程。
什么时候美国或加拿大专用号码更合适
Gateway 号码只接收一条验证码，用完即失效。如果 Twitch 账号之后还需要验证码，比如两步登录，或共用团队登录的账号找回，那么专用号码（Dedicated Number）是更合适的工具。它们即时开通，仅限美国和加拿大，每月 $1.95 起，并会把入站短信转发到你的 webhook。
无论选哪种，都请遵守 Twitch 的条款：每个真实的人或企业一个账号。OTP Route 用于测试和运营你自己的合法账号与产品，并受其《可接受使用政策》约束。
常见问题
没有个人手机，也能接收 Twitch OTP 吗？
可以。团队可以在 OTP Gateway 为 twitch 订购一个号码，并在控制台中读取验证码，让员工手机不再绑在品牌账号上。
一条 Twitch 验证码要多少钱？
每条 $0.20 起，取决于国家。下单前，实时价格由 GET /api/v1/prices 提供。
为什么 Twitch 没有向我的号码发送验证码？
送达情况取决于线路，Twitch 也可能拒绝部分虚拟号码。请等窗口期结束以获得自动退款，然后稍后再试或换一个国家。
Twitch 虚拟号码适合用于双重验证登录吗？
只有长期线路才合适。请使用美国或加拿大的专用号码，因为 Gateway 号码只接收一条验证码。
可以在 CI 中运行 Twitch 短信验证测试吗？
可以。通过 API 在流水线中触发订单并消费 webhook；开发期间使用沙盒可避免动用钱包资金。
OTP Route 与 Twitch 有关联吗？
没有。Twitch 是其所有者的商标，OTP Route 与其没有任何关联。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。