获取 +242 验证码的完整流程需要调用哪些 API？
所有接口都位于 https://otproute.com/api/v1 之下，使用以 or_live_ 开头的 Bearer 密钥认证。密钥在开发者控制台生成；一个账户最多可持有 10 个，便于为预发布环境、CI 和同事的笔记本分别配置凭据，并能独立吊销。
一次典型的布拉柴维尔市场测试流程如下：
- 拉取
GET /api/v1/services和GET /api/v1/countries，并缓存这些 id。刚果共和国是cg（不要与它较大的邻国混淆，后者有自己的 id 和页面：刚果（金））。 - 用
GET /api/v1/prices?country=cg&service=<id>查询你要测试的应用的实时价格和可用情况。 - 用
POST /api/v1/activations创建激活，请求体形如{"service": "telegram", "country": "cg"}。你会收到一个激活 id 和一个 +242 号码。 - 把该号码输入你自己产品的注册或登录界面。
- 通过 webhook 推送或轮询
GET /api/v1/activations/{id}获取刚果验证码。如果测试中止，用POST /api/v1/activations/{id}/cancel释放它。
在测试套件开始前运行 GET /api/v1/balance，让余额耗尽的钱包使任务尽早失败，而不是跑到一半才出错。每分钟 300 次请求的限制，给几个并行的工作进程留出了足够余量。完整的请求和响应结构见开发者文档。
如何为刚果的激活配置签名 webhook？
一位工程师逐步点击流程时轮询就够了；对 CI 集群来说，webhook 更友好。在开发者控制台添加一个端点（每个账户允许 5 个），并订阅 activation.sms_received、activation.expired 和 activation.cancelled。
每个请求都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。请使用该端点的密钥重建 "<t>.<raw body>" 的 HMAC-SHA256，用常量时间比较方式与 v1 对照，并丢弃时间戳已过期的请求。请在任何 JSON 解析之前对原始字节计算哈希，因为重新序列化的 JSON 很少能做到逐字节一致。
把事件视为以激活 id 为键。如果同一事件到达两次，你的处理器应当发现该 id 已处理完毕，并直接返回成功状态。Webhook 捕获指南介绍了队列模式，可避免较慢的测试执行器超时。
刚果验证号码可以覆盖哪些服务？
今天 cg 的快照包括 WhatsApp、Telegram、Google（Gmail 和 YouTube）、Facebook、Instagram、TikTok、X（Twitter）、ChatGPT（OpenAI）、Claude、Microsoft & Outlook、LinkedIn、Signal、Viber 和 imo。该国在 OTP Gateway 上总共有超过 1,000 项服务。
这份列表会在一天之中随着线路的开启和关闭而变化，所以不要硬编码。让你的测试框架向价格接口查询它需要的具体服务，并在没有可用库存时优雅地跳过或重新安排。即时通讯应用往往在刚果的阵容中占主导，这与当地许多客户初次接触新产品的方式相符：通过聊天群里分享的链接，而不是在应用商店搜索。
+242 号码应如何存储和规范化？
刚果共和国的号码在国家代码之后有九位数字，而且与许多号码方案不同，开头的 0 是用户号码的一部分，而不是冠码。手机号在本地通常写作 06… 或 05…，国际写法为 +242 06…。从欧洲代码库复制来的、会去掉任何前导零的规范化函数，会悄悄地破坏这些号码，所以请原样保存 API 返回的 E.164 字符串，并按国家校验长度，而不要使用一条全球通用的规则。
法语是官方语言，也是验证短信常用的语言，不过林加拉语和基图巴语在日常生活中也被广泛使用。部分模板中会出现带重音的字符，请确保你的解析器用模式提取数字，而不是依赖固定的英文措辞。
团队通常在以下情况下于此测试：将产品推向中非法语区、为布拉柴维尔或黑角的运营人员提供支持，或服务那些仍用本国号码注册的海外刚果客户。在真实的 +242 线路上检查整个流程，可以发现模拟器会漏掉的格式和文案问题。
如果 +242 号码收不到验证码怎么办？
没有动静通常是线路或接受度问题，而不是集成缺陷。一套合理的处理办法：
- 在下结论之前让 20 分钟的窗口走完；有些发送方会批量发送外发流量。
- 确认目标服务接受虚拟号码。有几个服务不接受，这正是未收到验证码不需要付费的原因。
- 稍后重试，或切换到另一条服务线路，而不是在紧凑的循环中不断下新订单而耗尽频率限制。
- 取消不再需要的号码，这样款项会立即退回，而不必等到过期。
我们的文章 减少 OTP 投递失败 更深入地介绍了退避与重试预算。
我能保留长期使用的刚果号码吗？
刚果共和国没有自助开通的长期号码。OTP Gateway 每接收一条验证码发放一个号码，这也是目前为 cg 提供的唯一产品。
OTP Route 的 Dedicated Virtual Numbers 是面向美国和加拿大的产品，每月 $1.95 起，包含收发短信和浏览器通话。如果你的团队确实需要持久的刚果号码，请发邮件至 [email protected]；能否安排取决于当地规定，所以请把它当作一次咨询，而不是承诺。两者的取舍总结在临时号码与专属号码中。
刚果 OTP 路由方案如何计费，又如何安全测试？
计费来自一个预付的美元钱包，没有订阅，也没有套餐档位。可以用银行卡或 USDT/USDC 稳定币充值，每次充值都会通过邮件产生一份 PDF 发票，供财务团队使用。
在把真实资金接入流水线之前，请让支持团队把开发账户切换到沙盒模式。它返回模拟的号码和验证码，让你无需花费任何费用，就能端到端地演练完整的短信验证 API 路径。请只在你自己的产品和你有权运营的账户上使用 OTP Route；每个服务的条款和我们的《可接受使用政策》依然适用。费用和退款如何出现在钱包中，请参阅定价。
常见问题
OTP Route API 中刚果共和国的国家 id 是什么？
是 cg。刚果民主共和国是另一个国家，有自己的 id，所以请仔细核对你的配置引用的是哪一个。
没有当地 SIM 卡，也能测试我的应用的刚果注册流程吗？
可以。从 OTP Gateway 订购一个用于测试的 +242 号码，填入你的应用，然后在控制台或通过 API 读取验证码。
保存 +242 号码时要去掉前导零吗？
不要。在刚果共和国，0 属于九位数的用户号码，所以请原样保留 API 返回的 E.164 值。
刚果的验证短信会使用什么语言？
多数为法语，国际应用有时使用英语。请用模式提取数字，而不要匹配特定词语。
如果验证码一直没有出现，我会被收费吗？
不会。如果窗口结束仍没有短信，或者你先取消，全部金额会自动退回你的钱包。
接收一条刚果短信 OTP 需要多少钱？
每条 $0.20 起；每个应用的 +242 价格都是实时报价，所以下单前请先查询。
有沙盒可用来搭建集成吗？
有，需按需申请。支持团队可以把开发账户置于沙盒模式，它返回模拟的号码和验证码，而不会动用钱包资金。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。