把阿根廷(+54)验证码接入你的集成系统

国际区号 +54OTP Gateway,每条验证码低至 $0.20专属号码:仅限美国和加拿大API 标识: ar
快速解答

可以:OTP Route 通过 OTP Gateway 为你接收阿根廷(+54)验证码,验证码会显示在控制台,并通过 REST 轮询或签名 Webhook 推送到你的后端。价格每个验证码 $0.20 起,只有短信在 20 分钟激活窗口内到达,这笔费用才会真正扣除。

+54 激活背后的四个 API 调用是什么?

所有接口都在 https://otproute.com/api/v1 之下,并使用以 or_live_ 开头的 Bearer 密钥认证。密钥在开发者控制台中签发;一个账户最多可持有 10 个密钥、注册 5 个 Webhook 端点,每分钟上限为 300 次请求。

  1. 先报价。 调用 GET /api/v1/prices?country=ar&service=<id>,让你的代码在动用钱包资金之前就知道实时费用。阿根廷的国家 ID 是 ar。
  2. 再下单。 发送 POST /api/v1/activations,JSON 请求体为 {"service": "whatsapp", "country": "ar"},其中的服务换成你测试所需的服务 ID。响应中包含激活 ID 和需要输入被测应用的 +54 号码。
  3. 等结果。 要么按合理的间隔读取 GET /api/v1/activations/{id},要么让 activation.sms_received Webhook 告诉你验证码已到。
  4. 需要时提前释放。 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 团队常用的包括:

这份列表在一天中会变化,所以 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 号码吗?

可以。客服、增长和代理机构的同事可以完全在浏览器里完成:

  1. 在注册页面用电子邮箱和 6 位验证码,或通过 Google 登录创建账户。
  2. 给钱包充值。
  3. 打开 OTP Gateway,选择阿根廷,然后选择你要测试的服务。
  4. 查看显示的价格并确认,再把 +54 号码复制到应用的验证页面。
  5. 观察这次激活;验证码一收到就会显示在那里。

控制台和 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 与其无任何关联。请合法使用号码,并遵守各服务的条款及我们的可接受使用政策。

几分钟内路由您的第一条 OTP

创建免费账户,为美元钱包充值,然后在控制台或通过 API 订购号码。无月费。