一次 +238 激活会用到哪些接口?
佛得角 OTP API 的集成只需要 https://otproute.com/api/v1 下的几个调用。每个请求都带有以 or_live_ 开头的 Bearer 密钥,该密钥在开发者控制台生成。佛得角的国家 ID 是 cv;服务 ID 是你要测试的应用对应的 api_service 值。
GET /api/v1/services和GET /api/v1/countries用于获取目录;可缓存一天。GET /api/v1/prices?country=cv&service=<id>读取当前价格,并告诉你此刻该线路是否开放。库存会在一天中变化,所以请在每次下单前查询,不要写死任何内容。POST /api/v1/activations,请求体{"service": "whatsapp", "country": "cv"},返回激活 ID 以及要填入注册表单的 +238 号码。- 如果不使用 Webhook,可以用
GET /api/v1/activations/{id}轮询验证码。 - 测试中止时,用
POST /api/v1/activations/{id}/cancel释放号码,冻结的金额会退回钱包。
运行前调用一次 GET /api/v1/balance,可以让测试套件提前停下,而不是在中途失败。上限为每个账户每分钟 300 次请求,API 参考文档列出了所有字段。
如何接收佛得角验证码的签名 Webhook?
轮询适合单个脚本;一旦有多个任务并行运行,Webhook 会更整洁。在开发者控制台注册一个端点(一个账户最多可持有五个),并订阅 activation.sms_received、activation.expired 和 activation.cancelled。
每个 POST 请求都带有 X-OTPRoute-Signature 请求头,格式为 t=<unix>,v1=<hex>。重新拼出字符串 <t>.<raw body>,用该端点的密钥做 HMAC-SHA256 签名,并以恒定时间比较的方式将结果与 v1 对照。丢弃时间戳超过几分钟的请求,避免被截获的请求遭到重放。之后,以激活 ID 作为处理的键:如果同一事件送达两次,第二份不应改变任何结果。我们的文章用 HMAC 保护 OTP Webhook涵盖了各种边界情况。
目前哪些应用可以向佛得角号码发送验证码?
cv 的实时目录覆盖 800 多项服务。目前开放的常用服务包括 WhatsApp、Facebook、Instagram、TikTok、Google(Gmail 和 YouTube)、Microsoft 和 Outlook、Amazon、Airbnb、Uber、Viber、Telegram 以及 Netflix。请把这份列表当作快照:线路会随合作伙伴的容量开放或关闭,这正是通过 API 做 OTP 路由的意义所在,它实时报告可用性,而不是由一个页面来作出承诺。
如果团队里没人写代码,控制台也能完成同样的工作。选择服务,选择佛得角,确认屏幕上的价格并复制号码。验证码到达时会显示在激活卡片上。
存储时,+238 号码长什么样?
佛得角采用封闭编号方案:国内号码为七位,没有长途前缀,因此不存在需要去掉的前导零。用 E.164 表示,号码就是 +238 加这七位数字。规范化因此非常简单,但这个较短的长度会难倒假定所有用户号码都更长的校验器,这是表单拒绝合法佛得角号码的常见原因。请存储 E.164 字符串,界面上想怎么格式化都行,并在手机号输入框的单元测试里加入一条 +238 用例。
葡萄牙语是官方语言,而佛得角克里奥尔语才是大多数人的日常用语,所以请检查葡萄牙语的 OTP 模板在当地手机上如何显示。团队通常因为侨民群体而需要 +238 号码来做测试:佛得角社区在美国、葡萄牙和欧洲其他地区的成员,往往把账户绑定在家乡的号码上,汇款、旅行和通讯类产品都希望这些用户的注册能顺利完成。
如果 20 分钟内没有收到短信,钱包会怎样?
每次激活保持开启 20 分钟。如果在此窗口内收到验证码,扣费有效;如果窗口结束时一无所获,或者你提前取消,全部金额会退回钱包,无需提交工单。当验证码没有到达时:
- 让窗口走完,而不是每隔几秒就重新下单;紧凑的重试循环只会占用资金。
- 稍后再试,或者通过另一条服务线路测试同一个流程。
- 确认该应用是否接受虚拟号码;有些按政策拒绝,退款机制正是为这种情况而设。
- 确认你的表单提交的是完整的 +238 号码,而不是被截断的号码。
减少 OTP 投递失败指南对排查有更深入的讲解。
我能为反复登录保留一个佛得角号码吗?
无法自助购买。OTP Route 的专属号码(Dedicated Numbers)是可长期使用的号码,支持收发短信、浏览器拨打电话和 Webhook 转发,但仅限美国和加拿大,每月 $1.95 起。目前没有可自助购买的长期 +238 号码。如果你的团队确实需要,请发邮件至 [email protected];能否安排取决于当地规定,不作保证。对于需要反复登录的预发布账户,美国或加拿大的虚拟号码通常是更实际的选择。
使用如何计费?上线前如何测试?
计费来自单个预付美元钱包,没有月费,也没有套餐档位。可通过银行卡或 USDT/USDC 稳定币充值;每次充值都会通过邮件收到 PDF 发票,方便财务对账。在正式密钥动用钱包之前,可以申请把开发账户切换为沙盒模式:它会返回模拟的号码和验证码,这样你的短信验证 API 客户端的下单、Webhook 和取消流程就能在 CI 中运行,而无需花费分文。请参阅价格和 QA 测试概览。全程请遵守各服务的条款以及 OTP Route 的《可接受使用政策》。
常见问题
没有本地 SIM,我能测试应用的佛得角注册流程吗?
可以。从 OTP Gateway 申请一个 +238 号码,填入你的注册表单,然后从控制台、API 或 Webhook 读取验证码。团队里没有人需要身在岛上。
OTP Route API 中佛得角的国家 ID 是什么?
是 cv。在 POST /api/v1/activations 和价格查询中,把它作为 country 传入。
佛得角号码前面需要加 0 吗?
不需要。佛得角没有长途前缀,所以国际格式就是 +238 加七位国内号码。
一个佛得角验证号码多少钱?
OTP Gateway 的价格从每个验证码 $0.20 起,因服务而异;API 和控制台会在你下单前显示确切价格。只有验证码到达才会收费。
所有应用都会向佛得角虚拟号码发送验证码吗?
不会。有些服务拒绝虚拟号码,线路也会在一天中变化。如果 20 分钟内没有收到验证码,金额会退回钱包。
有沙盒可以测试 +238 集成吗?
有,需申请。可以将开发账户切换为沙盒模式,它会返回模拟的号码和验证码,让集成端到端运行而不动用钱包资金。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。