开始之前:+1 721 测试要检查什么
荷属圣马丁属于北美编号计划,这让许多测试套件栽的跟头比它的体量所预示的要多。请先过一遍这份清单:
- 地区识别。 以
+1 721开头的号码属于荷属圣马丁,而不是美国。请确认你的电话号码库把它映射到地区SX。 - 格式。 E.164 是
+1721加七位数字;本地写作 (721) 加七位号码。输入时去掉空格、括号和连字符。 - 国家列表。 确保荷属圣马丁在你的国家选择器中与岛屿法属一侧的圣马丁(使用
+590)分开列出。 - 文案和语言。 荷兰语和英语是官方语言,日常使用的是英语,所以验证码通常以英语到达。
- 服务可用性。 确认你正在测试的应用在该线路的实时列表中。
荷属圣马丁号码上有哪些服务可以接收验证码?
当前快照包括 WhatsApp、Facebook、Instagram、Google(Gmail 和 YouTube)、Airbnb、Uber、Amazon、Netflix、Telegram、TikTok、Snapchat、eBay 以及 Microsoft 和 Outlook,这很适合旅游和酒店团队检查他们在这个以旅游业为主的岛屿上的流程。该线路总共覆盖超过 200 项服务。
与大型市场相比,这个目录较窄,而且经常变化。运行前请查询 GET /api/v1/countries 和 GET /api/v1/services。如果某项服务缺失,你的场景也可以去看看邻近的加勒比线路,例如库拉索或安圭拉。
分步指南:通过 API 订购 +1 721 号码
- 在开发者控制台生成密钥(以
or_live_开头),并以 Bearer 令牌的形式发送到https://otproute.com/api/v1。 - 读取价格:
GET /api/v1/prices?country=sx&service=airbnb。 - 下单:
POST /api/v1/activations,请求体为{"service": "airbnb", "country": "sx"}。 - 将返回的号码输入应用的验证页面。
- 从
activation.sms_receivedWebhook 获取验证码,或轮询GET /api/v1/activations/{id}。 - 验证
X-OTPRoute-Signature(用你的端点密钥对<t>.<raw body>做 HMAC-SHA256),并拒绝过期的时间戳。
对于这样的加勒比小线路,账户限制很少会成为瓶颈,但它们是 10 个密钥、5 个 Webhook 端点和每分钟 300 次请求。关于 CI 的做法,请参阅 CI 流水线中的 OTP 测试和文档。
分步指南:面向非开发人员的控制台路径
客服人员和市场人员无需写代码也能做同样的事。登录,选择荷属圣马丁和服务,然后点击下单。把号码复制到应用中,然后保持控制台打开:验证码到达后会显示在那里。价格会在你确认之前显示。
这条路径适合一次性的检查,比如在发布之后,确认酒店合作伙伴的员工账号是否仍能用荷属圣马丁号码完成验证,而不必请工程团队编写脚本。
排查荷属圣马丁验证码缺失
每个激活都有 20 分钟的窗口。如果这段时间内没有收到任何内容,或你通过 POST /api/v1/activations/{id}/cancel 取消,全部金额会自动退回钱包。
- 在把此次尝试视为失败之前,先给窗口留出时间。
- 检查该服务是否接受虚拟号码;有些会拒绝。
- 稍后重试或使用其他服务线路,而不是循环重新下单。
- 如果你的应用在发送之前就拒绝了号码,请检查地区识别:假定每个
+1号码都属于美国或加拿大的校验器在这里会出错。
+1 721 意味着有专属号码可用吗?
没有。共用 +1 前缀并不会让荷属圣马丁成为专属号码计划的一部分。长期线路只在美国和加拿大提供自助购买,每月 $1.95 起,包含入站短信、Webhook 转发和浏览器通话;详情见虚拟号码。荷属圣马丁没有可自助购买的长期线路。你可以发邮件至 [email protected] 咨询,但能否办理取决于当地规定。
计费和沙盒
OTP Route 使用一个预付美元钱包,没有月费。可用银行卡或 USDT/USDC 充值,每次充值都会通过邮件收到 PDF 发票。开发账户可应要求切换到沙盒,这样你就可以用模拟的号码和验证码测试集成。
号码只能用于你自己的产品和合法的企业账户,请遵守各服务的条款,并遵循《可接受使用政策》。
常见问题
+1 721 号码会被当作美国号码吗?
不会。它是荷属圣马丁在北美编号计划内的区号,你的校验器应将其归类为地区 SX。
OTP Route 对荷属圣马丁使用哪个国家 id?
id 是 sx,用于 POST /api/v1/activations 等调用。
没有本地 SIM 卡,我能测试预订应用的荷属圣马丁注册流程吗?
可以。为该服务订购一个临时的 +1 721 号码,输入后在控制台或通过 API 读取验证码。
为什么荷属圣马丁的服务列表比其他国家短?
较小线路的覆盖范围经常变化。请通过 API 或控制台查看实时列表,如有需要可考虑邻近的线路。
荷属圣马丁号码收不到验证码时我需要付费吗?
不需要。20 分钟窗口结束仍没有短信,或你取消了,全部金额会退回你的钱包。
荷属圣马丁的验证号码多少钱?
价格每条验证码 $0.20 起,取决于服务;API 会在你下单前返回确切金额。
岛屿的法属一侧也由同一条线路覆盖吗?
不是。圣马丁(法属)使用 +590,属于另一个编号区,所以在测试中请把它当作不同的国家。
我的应用的电话字段应该接受以 (721) 加七位数字输入的号码吗?
应该。接受本地写法,然后在存储或发送之前将其规范化为 +1721 加这七位数字。
服务名称均为其各自所有者的商标,OTP Route 与其无任何关联。请合法使用号码,并遵守各服务的条款及我们的可接受使用政策。