+54 激活背后的四个 API 调用是什么?
所有接口都在 https://otproute.com/api/v1 之下,并使用以 or_live_ 开头的 Bearer 密钥认证。密钥在开发者控制台中签发;一个账户最多可持有 10 个密钥、注册 5 个 Webhook 端点,每分钟上限为 300 次请求。
- 先报价。 调用
GET /api/v1/prices?country=ar&service=<id>,让你的代码在动用钱包资金之前就知道实时费用。阿根廷的国家 ID 是ar。 - 再下单。 发送
POST /api/v1/activations,JSON 请求体为{"service": "whatsapp", "country": "ar"},其中的服务换成你测试所需的服务 ID。响应中包含激活 ID 和需要输入被测应用的 +54 号码。 - 等结果。 要么按合理的间隔读取
GET /api/v1/activations/{id},要么让activation.sms_receivedWebhook 告诉你验证码已到。 - 需要时提前释放。
POST /api/v1/activations/{id}/cancel会终止你不再需要的激活,并把钱退回钱包。
如果想在写死 ID 之前先看一眼,GET /api/v1/services 和 GET /api/v1/countries 会列出平台当前提供的内容。完整的参考资料见文档。
如何让阿根廷验证码的 Webhook 接收端值得信赖?
每次投递都带有形如 t=<unix>,v1=<hex> 的 X-OTPRoute-Signature 请求头。重建字符串 "<t>.<raw body>",用该端点的密钥计算 HMAC-SHA256,再用恒定时间函数把结果与 v1 比较。丢弃时间戳过期的请求,因为一个旧但有效的签名,正是重放攻击的样子。
除了 activation.sms_received,还请订阅 activation.expired 和 activation.cancelled,这样测试运行器就不会一直等一个已经关闭的号码。把每个事件都视为以激活 ID 为键,并让处理程序在同一事件被第二次投递时不产生任何变化。关于签名与校验 OTP Webhook 的文章对比较逻辑有更深入的讲解。
我可以用阿根廷号码验证哪些应用?
阿根廷的实时快照列出超过 2,000 项服务。阿根廷的产品和 QA 团队常用的包括:
- 即时通讯:WhatsApp、Telegram、Signal、Discord
- 账户与办公:Google (Gmail & YouTube)、Microsoft & Outlook、LinkedIn、ChatGPT (OpenAI)
- 社交与视频:Instagram、TikTok
- 电商与出行:Amazon、Uber、Airbnb、Netflix
这份列表在一天中会变化,所以 API 实时报告可用性,而不是提供一张静态表格。在定时 CI 任务启动之前,请结合 ar 国家查询 GET /api/v1/services,如果目标服务暂时缺失,就快速失败并给出清晰的提示。
为什么阿根廷手机号会让号码校验器出错?
阿根廷的编号方案在这个地区算是比较特别的。在国内,人们会在区号前写长途冠码 0,手机号还要在用户号码前加 15,所以布宜诺斯艾利斯的手机号可能写成 011 15 加八位数字。在国际 E.164 格式中,这两者都会消失,并在国家代码之后紧接着插入一个 9:+54 9 11,然后是八位用户号码。
这个差别对任何需要存储手机号的人都很重要。请在保存前把一切规范化为 E.164,输入时去掉 0 和 15,并为手机号加上 9。只检查长度的校验器会欣然接受一个固话风格的 +54 11 号码,而它并不能接收短信。请直接使用 API 返回的号码,不要自己重新格式化。
发往阿根廷号码的验证码通常以西班牙语到达,数字前后常有类似 "Tu código es" 的措辞。请用模式匹配提取数字验证码,而不要匹配文字,因为模板会变化。团队在这里测试,通常是为了进入拉丁美洲市场、检查拉普拉塔河地区的西班牙语文案(当地的 vos 变位与教科书上的西班牙语不同)、开展区域运营,或服务仍用 +54 SIM 卡注册的海外阿根廷人。
不会写代码的人也能订购 +54 号码吗?
可以。客服、增长和代理机构的同事可以完全在浏览器里完成:
- 在注册页面用电子邮箱和 6 位验证码,或通过 Google 登录创建账户。
- 给钱包充值。
- 打开 OTP Gateway,选择阿根廷,然后选择你要测试的服务。
- 查看显示的价格并确认,再把 +54 号码复制到应用的验证页面。
- 观察这次激活;验证码一收到就会显示在那里。
控制台和 API 使用同一个钱包和同样的激活记录,所以开发人员可以凭激活 ID 接手同事订购的号码。
阿根廷的验证码没有出现,下一步怎么办?
每次激活会保持 20 分钟。如果什么都没有到达,或你先取消了,全部金额会自动退回钱包,所以静默的线路损失的是时间而不是金钱。投递速度取决于服务和线路,因此在判定失败之前,请给窗口一个公平的机会。
然后逐项排查这份简短的清单:
- 在应用内重新请求一次验证码,然后让窗口走完。
- 稍后在一天中的其他时段再试,或为同一服务换一条线路下单。
- 确认该服务是否接受虚拟号码;有些会拒绝,这正是设立自动退款的原因。
- 避免在 CI 中以紧凑循环重复下单。加入退避和重试次数上限。
我们关于减少 OTP 投递失败的文章介绍了更多适用于阿根廷线路的模式。请让每次测试都符合各服务的条款;OTP Route 的可接受使用政策同样适用。
我们能保留阿根廷号码吗?如何付款?
目前阿根廷没有自助式的长期号码。如果你的团队需要长期使用的 +54 号码,请发邮件至 [email protected] 并说明使用场景;能否安排取决于当地规定,无法保证。专用虚拟号码在续费期间归你使用,并会把收到的短信转发到你的 Webhook,它是美国和加拿大的产品,每月 $1.95 起。
计费通过一个预付费美元钱包进行,没有月费,也无需选择套餐。可用银行卡或 USDT/USDC 充值,每次充值都会通过电子邮件收到 PDF 发票。详情见价格页面。在动用真实资金之前,可以申请把开发账户切换为沙盒,它返回模拟的号码和验证码,让你演练整个阿根廷流程。
常见问题
OTP Route API 中阿根廷的国家 ID 是什么?
是 ar。请把它传入 POST /api/v1/activations 的 country 字段,以及 GET /api/v1/prices 的查询字符串。
在应用里输入 +54 号码时需要加 9 吗?
请完全按 OTP Route 返回的号码使用。在你自己的数据库里,请以 E.164 格式存储阿根廷手机号,即在 +54 之后包含 9,并去掉国内的 0 和 15。
接收阿根廷短信 OTP 要多少钱?
每个验证码 $0.20 起,因服务而异。确切金额由 GET /api/v1/prices 返回,并在你确认订单之前显示出来。
没有当地 SIM 卡,我能测试应用的阿根廷注册流程吗?
可以。为你自己的应用或测试中的第三方服务订购一个阿根廷激活,输入 +54 号码,然后在控制台或你的 Webhook 中读取验证码。
下个月登录时,同一个 +54 号码还能用吗?
不能。网关号码只在 20 分钟内负责一个验证码。对于必须持续接收验证码的账户,合适的选择是美国或加拿大的专用号码。
阿根廷的验证短信会是什么语言?
通常是西班牙语,但取决于发送方和账户的语言设置。请提取数字,不要依赖周围的文字。
可以用轮询代替 Webhook 吗?
可以。以适中的间隔轮询 GET /api/v1/activations/{id},并让每个账户的请求量远低于每分钟 300 次的限制。
服务名称均为其各自所有者的商标,OTP Route 与其无任何关联。请合法使用号码,并遵守各服务的条款及我们的可接受使用政策。