为什么在国外很难验证 +257 的注册流程?
设想一个产品团队要把布隆迪加入东非的上线计划。注册页要求输入手机号,后端发送一次性验证码,而团队里没有人持有布隆迪 SIM 卡。出差时买的漫游 SIM 会过期;请布琼布拉的同事把验证码念出来,既暴露了个人号码,也无法放进每晚运行的测试套件里。
OTP 路由解决了这个瓶颈。你无需实体手机,而是为某个特定服务申请一个布隆迪验证号码,验证码由 OTP Route 捕获,你的测试框架像读取任何其他事件一样读取它。对于需要管理布隆迪线路上企业资料、又不想让自己手机卷进来的运营人员,这种做法同样适用。
目前哪些服务可以用布隆迪号码验证?
布隆迪的实时快照列出了常见的即时通讯、搜索和电商应用,包括 WhatsApp、Viber、imo、Telegram、Signal、Google(Gmail 和 YouTube)、Facebook、Instagram、TikTok、LinkedIn、Microsoft 和 Outlook、ChatGPT(OpenAI)、Uber 以及 Amazon。这条线路总共覆盖 1,000 多项服务。
库存会在一天中变化,所以请把这份列表当作起点,而不是承诺。你的代码应通过 GET /api/v1/services 和 GET /api/v1/countries 获取当前情况,完整目录也可以在国家下浏览。
布隆迪 OTP API 如何融入一次测试运行?
在开发者控制台创建一把密钥;正式密钥以 or_live_ 开头,放在 Bearer 请求头中,请求地址为 https://otproute.com/api/v1。一次典型的自动化检查如下:
- 调用
GET /api/v1/prices?country=bi&service=whatsapp,读取该组合的当前价格。 - 发送
POST /api/v1/activations,请求体为{"service": "whatsapp", "country": "bi"}。响应中包含激活 ID,以及要填入被测应用的 +257 号码。 - 等待
activation.sms_receivedWebhook,或以合理的间隔轮询GET /api/v1/activations/{id}。 - 对验证码做断言,然后结束测试。
Webhook 请求带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>,这是以端点密钥为密钥,对 <t>.<raw body> 计算的 HMAC-SHA256。请重新计算并以恒定时间比较,同时丢弃时间戳过旧的请求;这篇详解涵盖了细节。每个账户最多可持有 10 把密钥和 5 个 Webhook 端点,请求上限为每分钟 300 次。完整参考:文档。
我的校验逻辑应该如何预期布隆迪号码?
布隆迪采用封闭编号方案:国家代码之后的用户号码为八位数字,没有需要去掉的国内长途前缀。用 E.164 表示就是 +257 加八位数字,不含空格。表单经常按两位一组显示,所以请在保存前对输入做规范化,去掉空格、连字符和开头的 00。
常见的缺陷是:校验器按九位或十位的国内号码编写,悄悄拒绝了合法的 +257 输入。请在单元测试里为这个长度加一条用例。
基隆迪语、法语和英语是官方语言,斯瓦希里语在贸易中被广泛使用。全球性应用发送的验证短信通常是英语或法语,取决于发送方自己的区域逻辑,所以请解析数字,而不是匹配措辞。
验证码没有到:接下来怎么办?
每次激活保持开启 20 分钟。如果在此期间号码没有收到短信,或者你通过 POST /api/v1/activations/{id}/cancel 取消,全部金额会自动退回你的钱包。
- 在判定失败之前先等窗口走完,有些发送方会排队发送。
- 确认目标服务是否接受虚拟号码,因为有些服务按政策拒绝。
- 稍后重试,或者通过另一条服务线路测试同一个流程。
- 避免在紧凑循环里重复下单,两次尝试之间请适当退避。
更喜欢用控制台?登录后选择布隆迪和服务,把号码复制到应用里,然后看着验证码出现在屏幕上。更多应对方法见减少 OTP 投递失败。
我们能保留一个布隆迪号码,用于反复登录的账户吗?
无法自助购买。OTP Route 不出售布隆迪的长期号码;OTP Gateway 每次验证只提供一个号码。如果你的团队确实需要在当地使用固定号码,请发邮件至 [email protected] 并说明使用场景;能否提供取决于当地规定,不作保证。
专属虚拟号码(Dedicated Virtual Numbers)仅限美国和加拿大,每月 $1.95 起,支持接收短信、Webhook 转发和浏览器拨打电话。如果美国或加拿大号码适合你的预发布账户,请查看虚拟号码。
布隆迪的使用如何计费?
只有一个预付美元钱包,没有月费,也不用选择套餐。可通过银行卡或 USDT/USDC 稳定币充值;每次充值后,财务会收到邮件发送的 PDF 发票。在把支付接入 CI 之前,可以申请把开发账户切换为沙盒模式,它会返回模拟的号码和验证码,不会动用钱包资金。
请只把号码用于你自己的产品或合法的企业账户,遵守每个服务的条款,并记住 OTP Route 的《可接受使用政策》同样适用。当前价格见价格。
常见问题
没有本地 SIM,我能测试应用的布隆迪注册流程吗?
可以。从 OTP Gateway 为你的服务申请一个 +257 号码,填入应用,然后从控制台、API 或 Webhook 读取验证码。
API 中布隆迪使用什么国家 ID?
将 bi 作为国家值传入,例如在 POST /api/v1/activations 中,与 telegram 之类的服务 ID 搭配使用。
如果 +257 的验证码没有到,会被收费吗?
不会。如果 20 分钟窗口内没有收到任何短信,或者你取消了激活,全部金额会自动退回你的钱包。
布隆迪号码有需要去掉的前导零吗?
没有。布隆迪没有长途前缀,所以 E.164 格式就是 +257 加八位数字。
布隆迪的验证短信会用什么语言?
取决于发送服务,但通常是英语或法语。请提取其中的数字验证码,不要依赖短信文字。
下个月我还能继续使用同一个布隆迪号码吗?
不能。Gateway 号码只服务于一次验证。需要重复登录时,仅美国和加拿大提供专属号码。
一个布隆迪验证号码多少钱?
布隆迪的价格 $0.20 起,具体金额按服务而定。确切价格由 GET /api/v1/prices 返回,并会在你下单前显示。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。