如何设计以 Webhook 为先的圭亚那 OTP API 流程?
除了一次性检查之外,最好让平台把验证码推送给你,而不是一遍遍地去询问。在开发者控制台添加一个 HTTPS 端点(每个账号可以有 5 个),并订阅 activation.sms_received,同时订阅 activation.expired 和 activation.cancelled,这样测试运行器得知失败的速度和得知成功一样快。
在通过验证之前,把每个传入请求都视为不可信:
- 读取
X-OTPRoute-Signature请求头,格式为t=<unix>,v1=<hex>。 - 把时间戳、一个点号和未经修改的请求体拼接起来,用端点密钥对这个字符串计算 HMAC-SHA256。
- 以恒定时间比较你的摘要与
v1,如果时间戳已过期,就丢弃该请求。 - 从事件中找到激活 id;如果已经处理过,就返回成功,不再做其他事情。
最后这条规则让处理程序保持幂等,所以网络波动后的重新投递不会干扰测试。更详细的内容见 基于 Webhook 的 OTP 捕获。
+592 订单会用到哪些端点和 id?
使用开发者控制台里的 Bearer 密钥认证;正式密钥以 or_live_ 开头,每个账号最多可保留 10 个。基础 URL 是 https://otproute.com/api/v1,圭亚那的国家 id 是 gy。
典型的一次运行会先读取 GET /api/v1/prices?country=gy&service=<id>,因为这条线路上的价格和可用情况是实时数值,而不是常量。然后发送 POST /api/v1/activations,请求体为 {"service": "<id>", "country": "gy"},拿到一个 +592 号码和一个激活 id。如果不用 Webhook,运行器每隔几秒轮询一次 GET /api/v1/activations/{id},远低于每分钟 300 次请求的上限。测试中止时,清理步骤会调用 POST /api/v1/activations/{id}/cancel,而预检阶段调用 GET /api/v1/balance 可在钱包余额不足时提前终止测试套件。服务 id 来自 GET /api/v1/services;开发者中心提供了这套短信验证 API 的客户端示例。
+592 号码该如何格式化存储?
圭亚那的国家代码是 592,国内号码为七位数字,没有需要去掉的长途前缀,所以 E.164 格式就是 +592 加这七位数字。人们通常把数字写成三位和四位两组。
由于没有前导零要去掉,规范化只需删除空格和短横线,并在用户只输入本地数字时补上国家代码。一个常见的错误是,表单假定每个南美洲号码都有区号,或把最小长度设置在七位以上,从而拒绝有效的圭亚那号码。用一个 +592 测试号码能很快暴露这个问题。保存 E.164 字符串,只在显示时才应用本地格式。
哪些服务可以接收圭亚那短信 OTP 验证码,可以手动下单吗?
圭亚那线路列出了 900 多项服务。常被请求的包括 WhatsApp、Facebook、Instagram、Google(Gmail 和 YouTube)、TikTok、Telegram、imo、Viber、Snapchat、Amazon、Microsoft 与 Outlook、Discord、Netflix 和 Claude。这份名单是实时目录的快照,所以在围绕某个特定发送方规划测试之前,请通过 API 或控制台确认。
对于不写代码的同事,控制台可以完成同样的工作。登录,打开 OTP Gateway,选择圭亚那和一项服务,查看价格,然后下单。圭亚那验证号码会与 20 分钟倒计时一起出现,验证码到达后会显示在旁边。
+592 验证码迟到或没有到达时,测试应该怎么做?
激活会保持 20 分钟的开放状态。只有验证码在该窗口内到达才需付费;如果过期或你取消了,全额金额会返还到钱包,无需提交任何支持工单。
自动化运行中的合理处理方式:
- 在宣告失败之前先等完整个窗口;如果你的测试有硬性时间限制,则显式取消。
- 稍后重试,或者如果 API 提供了别的服务线路,就切换过去。
- 检查目标服务是否接受虚拟号码;有些会拒绝,而退款正是涵盖这种情况。
- 用退避机制拉开重试间隔,而不要在紧凑的循环中重复下单。
OTP 国家路由指南介绍了如何选择备用线路。
为什么团队要测试圭亚那的注册流程?
圭亚那是南美洲唯一以英语为官方语言的国家,加勒比共同体(CARICOM)秘书处也设在乔治敦,所以在把加勒比共同体视为一个整体市场的推广中经常出现它。快速增长的海上能源产业吸引了国际承包商和供应商,而在美国、加拿大和英国的庞大侨民群体,让汇款、即时通讯和旅行类应用在 +592 号码上始终活跃。圭亚那克里奥尔语在日常生活中被广泛使用,但验证短信一般是英文。对 QA 来说,这意味着重点应放在号码输入、国家选择器和短信授权文案上,而不是翻译后的文案。所有检查都应只针对你所在组织拥有的账号,遵守各服务的条款,并请记住 OTP Route 的《可接受使用政策》适用于所有订单。
我可以保留圭亚那线路吗?用量如何计费?
圭亚那不提供自助式长期号码。OTP Route 的专属号码仅覆盖美国和加拿大,低至 $1.95/月。如需 +592 线路,请发邮件至 [email protected],团队会核实当地规定允许什么,但不作任何承诺。
付款通过一个预付美元钱包进行:没有月费,没有套餐,可用银行卡或 USDT/USDC 充值,每次充值都会通过邮件收到 PDF 发票。开发账号可按请求切换为沙盒,这样集成测试会针对模拟的号码和验证码运行,余额不受影响。各服务的价格见价格页面。
常见问题
没有圭亚那运营商的 SIM 卡,可以检查我的应用的圭亚那注册流程吗?
可以。从 OTP Gateway 为你的服务订购一个 +592 号码,在你的流程中提交,验证码会显示在控制台或送达你的 Webhook。价格低至每条验证码 $0.20。
API 使用什么国家 id 表示圭亚那?
是 gy,在价格查询和激活请求体中都使用它。
圭亚那号码需要去掉前导零吗?
不需要。圭亚那没有长途前缀,所以 E.164 格式就是 +592 加七位数字号码。
+592 验证短信使用什么语言?
通常是英语,即官方语言。不过措辞由发送方决定,也可能跟随应用的语言设置。
如果服务一直没发短信,可以退款吗?
可以,而且是自动的。如果 20 分钟过去仍没有验证码,或你取消了,全部金额会回到你的钱包。
可以不花钱测试整个集成吗?
请联系支持团队,把你的开发账号切换为沙盒。它会返回模拟的号码和验证码,这样 API 调用和 Webhook 都可以端到端地跑一遍。
有长期使用的 +592 号码吗?
没有自助式产品。专属号码只在美国和加拿大销售;如需了解圭亚那的情况,请发邮件至 [email protected] 咨询。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。