首次牙买加激活之前应该确认什么?
牙买加属于北美编号计划,因此有几项检查与大多数国家不同:
- 你的校验器接受非美国、非加拿大的 +1 号码。 许多注册表单会悄悄假设所有 +1 号码都是美国的。
- 你的国家选择器把牙买加单独列出,而不是把 +1 当作一个单一地区。
- 开发者控制台里已有一个
or_live_API 密钥,并且已部署带密钥的 Webhook 端点,或者你的测试框架已设置为轮询。 - 钱包已充值,或者已开启沙盒模式用于试运行。
- 你知道来自
GET /api/v1/services的服务 id;牙买加的国家 id 是jm。
前两项出错会产生看起来像路由问题的失败,但问题完全出在你自己的代码里。
为什么牙买加的 +1 号码需要特殊处理?
牙买加号码使用区号 876 以及较新的 658,后面跟七位用户号码,因此完整的 E.164 格式是 +1 加十位数字。国内长途拨号时人们会在前面拨一个 1,存储前应将其去掉。
对工程师来说重点在于,单看 +1 并不能说明国家。地区检测必须查看区号,任何根据拨号代码来选择币种、时区或短信模板的逻辑也需要同样小心。存储规范的 E.164 字符串,把检测出的地区放在单独的字段里,并同时测试 876 和 658 两种输入。
英语是官方语言,验证短信几乎总是以英语发送,而日常口语中常用牙买加克里奥尔语。团队在这里测试的原因包括加勒比地区的上线、服务美国、英国和加拿大侨民的汇款与金融科技流程,以及旅游和酒店类产品。OTP 国家路由一文介绍了如何为各个市场选择线路。
牙买加短信验证 API 有哪些步骤?
- 针对基础 URL
https://otproute.com/api/v1,用GET /api/v1/prices?country=jm&service=<id>查看实时价格。 - 下单:
POST /api/v1/activations,请求体为{"service": "<id>", "country": "jm"}。记下 activation id 和号码。 - 在被测应用中提交该号码。
- 通过 Webhook 上的
activation.sms_received事件,或轮询GET /api/v1/activations/{id}来接收验证码。 - 若要提前放弃牙买加的这次尝试,发送
POST /api/v1/activations/{id}/cancel,即可释放占用。
在处理任何事件之前,请使用端点密钥重新计算 "<t>.<raw body>" 的 HMAC-SHA256,与 X-OTPRoute-Signature 中的 v1 值比较,并拒绝过旧的时间戳。同时也要处理 activation.expired 和 activation.cancelled,并以 activation id 为键,这样重试永远不会重复处理。在容量规划方面,单个账号最多可拥有 10 个密钥和 5 个 Webhook 端点,它们合计每分钟最多 300 次请求。
牙买加线路上的哪些应用可以接收验证码?
牙买加目前列出超过 900 种服务。常用的包括 WhatsApp、Telegram、Google(Gmail 和 YouTube)、Facebook、Instagram、TikTok、X(Twitter)、Snapchat、Amazon、Uber、Netflix、Airbnb 以及 ChatGPT(OpenAI)。
各服务的可用性在一天中会变动,所以请在每次运行开始时读取价格接口,而不是把列表写死在代码里。
非开发人员如何在控制台中遵循同一份清单?
在 /signup 使用邮箱验证码或 Google 创建账号,启用 TOTP,然后充值。接着打开 OTP Gateway,选择服务,选择牙买加,并确认实时价格。把号码粘贴到应用中,短信到达后验证码就会出现在控制台里。客服人员经常用这种方式,在牙买加号码上重现客户的注册问题。
排错:牙买加验证码延迟、缺失或被拒绝
- 输入时就被拒绝? 先检查你自己的表单;只支持美国号码的校验器是常见元凶。如果第三方应用本身拒绝该号码,可能是它不接受虚拟号码。
- 还没有收到? 让激活保持它的 20 分钟,而不是取消后重新下单。
- 仍然没有? 稍后再试,或换用不同的服务线路。避免在循环里反复调用同一个订单。
当窗口结束前没有短信送达该号码时,全部费用会自动退回钱包。减少 OTP 投递失败指南提供了更完整的检查清单。
专用线路、钱包和沙盒适用于牙买加吗?
共用 +1 区号并不意味着牙买加属于专用号码产品。专用虚拟号码仅面向美国和加拿大销售,起价 $1.95/月,牙买加没有自助的长期号码。如果你需要,请发邮件到 [email protected] 询问;最终由当地规定决定,我们不作任何承诺。
其他一切与任何地方都一样:预付美元钱包,无月费,可通过银行卡或 USDT/USDC 充值,每次充值都会邮件发送 PDF 发票。沙盒模式可应要求开通,会返回模拟的号码和验证码用于集成测试。费用如何计算请参阅 /pricing。
常见问题
不在金斯敦也能测试我的应用的牙买加手机验证吗?
可以。通过 OTP Route 为你的服务订购 +1 876 或 +1 658 号码,无论团队身在何处,都可以在控制台或 API 中读取验证码。
牙买加应该传哪个国家 id?
传 jm。拨号代码是 +1,但 API 是通过这个 id 来识别国家的。
牙买加号码算美国号码吗?
不算。它与美国共用 +1 区号,但它是一个独立的国家,有自己的区号,许多应用也把它视为牙买加。
如果牙买加验证码没有到,我的钱会怎样?
如果 20 分钟内没有收到短信,或者你取消了订单,全部金额都会退回钱包。
我能从 OTP Route 购买牙买加的长期号码吗?
自助方式不行。长期专用号码仅覆盖美国和加拿大;如需了解牙买加的情况,请发邮件给客服。
有没有办法不付费就测试 Webhook 流程?
可以为开发账号申请沙盒模式。它会返回模拟的号码和验证码,基于 Webhook 的 OTP 捕获一文讲解了处理程序一侧的做法。
允许把 +1 牙买加号码用于哪些测试用途?
测试你自己的产品、QA 自动化,以及运营合法的企业账号。加勒比线路既受各应用自身条款的约束,也受 OTP Route《可接受使用政策》的约束。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。