赞比亚 OTP API 集成会调用哪些端点？
集成是一连串对 https://otproute.com/api/v1 的简短 HTTPS 调用，每个请求都携带 Authorization: Bearer 以及前缀为 or_live_ 的密钥。赞比亚的国家 ID 为 zm。
GET /api/v1/countries和GET /api/v1/services：参考数据，可放心缓存一天。GET /api/v1/prices?country=zm&service=<id>：实时价格，以及该线路此刻能否接受订单。POST /api/v1/activations，请求体为{"service": "whatsapp", "country": "zm"}：返回激活 ID 和一个 +260 号码。GET /api/v1/activations/{id}：状态，以及收到之后的验证码。POST /api/v1/activations/{id}/cancel：提前归还号码。GET /api/v1/balance：最先运行，让测试套件在钱包为空时迅速停止。
在开发者控制台生成密钥，每个账户最多 10 个，每个环境一个是一种整洁的做法。账户限额为每分钟 300 次请求。完整的数据结构见 API 文档。
接收 +260 验证码的 Webhook 应该怎样编写？
轮询可行，但一旦同时运行多个激活，Webhook 会更清爽。在开发者控制台最多添加 5 个端点，并订阅 activation.sms_received、activation.expired 和 activation.cancelled。
每个请求都携带 X-OTPRoute-Signature: t=<unix>,v1=<hex>。构造字符串 <t>.<raw body>，使用端点的密钥计算 HMAC-SHA256，并以恒定时间与 v1 比较。请使用收到时的原始字节，拒绝超过几分钟的时间戳，并以激活 ID 为键保存结果，这样被重试的推送不会改变任何东西。快速返回 2xx，之后再处理耗时的工作。我们关于使用 HMAC 保护 OTP Webhook的讲解有更多细节，而CI 流水线中的短信 OTP 测试展示了它在构建中的位置。
赞比亚验证号码可以接收哪些服务的验证码？
实时快照显示赞比亚有超过 1,100 项服务。其中包括：WhatsApp、Facebook、Google (Gmail & YouTube)、Telegram、Instagram、TikTok、X (Twitter)、LinkedIn、Uber、imo、Microsoft & Outlook、Amazon 和 Netflix。由于线路每小时都在变化，请在下单之前让价格接口告诉你的代码哪些线路是开放的。
赞比亚号码格式，以及验证码使用的语言
赞比亚号码在国内拨打时带有长途冠码 0，后跟九位数字。在国际格式中，这个零会去掉，得到 +260 后跟九位数字。保存之前，请把所有内容规范化为这种 E.164 格式，并确保你的输入框既接受用户实际键入的本地写法，也接受国际写法。
英语是官方语言，本巴语、尼扬加语、通加语和洛兹语等语言也被广泛使用。验证短信通常以英语到达，这使解析变得简单，但仍请按数字匹配，这样发送方措辞的改变不会破坏你的测试。
团队在赞比亚测试，通常是在拓展到南部非洲、为移动支付或借贷产品构建引导流程，或从区域运营中心支持客户时。金融科技引导页面涵盖了这类场景。
在控制台里也能做同样的事吗？
可以，而且很适合一次性检查。登录，打开 OTP Gateway，选择服务和赞比亚，查看显示的价格，然后下单。把 +260 号码输入应用；验证码到达时会显示在控制台中。取消一个你不再需要的激活，它的金额会退回钱包。
如果验证码没到怎么办？什么时候专属号码更合适？
激活持续 20 分钟，只有验证码到达时你才付费。如果窗口过期或你取消了，全部金额会自动退回。有些服务会拒绝虚拟号码，这就是退款存在的原因。当 +260 验证码较慢时：等完窗口，稍后再试或改用另一条服务线路，检查该服务是否接受虚拟号码，并避免在紧凑循环中重复下单。
对于之后还要再次登录或找回访问权限的账户，一次性号码是错误的工具。专属虚拟号码能担当这一角色，但仅限美国和加拿大，每月 $1.95 起。OTP Route 没有自助开通的长期赞比亚号码；如果你确有需要，请写信至 [email protected]，请记住这取决于当地规定，也不作任何保证。
号码只能用于你自己合法的产品和账户，请遵守各服务的条款，并请记住 OTP Route 的《可接受使用政策》适用。
赞比亚集成如何计费，又如何安全地测试？
一个预付美元钱包支付所有费用；没有月费，也没有套餐。可用银行卡或 USDT/USDC 充值，每次都会通过电子邮件收到 PDF 发票。开发期间，请为你的开发账户申请沙盒模式：模拟的号码和验证码让你无需花费钱包资金，就能演练完整的 OTP 路由路径。当前费率见价格页面。
常见问题
OTP Route 为赞比亚使用什么国家 ID？
zm，例如 POST /api/v1/activations 中的 {"service": "telegram", "country": "zm"}。
没有赞比亚 SIM 卡，我能接收赞比亚短信 OTP 验证码吗？
可以。OTP Gateway 提供用于测试的 +260 号码，验证码会通过控制台、Webhook 或轮询送达你。
如何正确存储 +260 号码？
去掉国内的长途冠码 0，并以 E.164 保存 +260 加九位数字。显示格式另行处理。
如果 WhatsApp 或其他服务拒绝了号码，钱会退回吗？
会。当 20 分钟内没有验证码到达，或你取消时，金额会自动退回你的钱包。
我能保留赞比亚号码用于以后登录吗？
不能自助开通。长期号码是美国和加拿大的产品；关于赞比亚，请发邮件至 [email protected] 询问，但不作承诺。
在为真实验证码付费之前，我能先试用集成吗？
可以。为开发账户申请沙盒模式，即可获得用于端到端测试的模拟号码和验证码。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。