巴哈马 OTP API 集成需要哪些请求？
巴哈马 OTP API 集成就是针对 https://otproute.com/api/v1 的一串简短调用，通过你在开发者控制台生成、前缀为 or_live_ 的 Bearer 密钥进行授权。巴哈马的国家 ID 是 bs；whatsapp 或 telegram 之类的服务 ID 来自目录。
- 用
GET /api/v1/services和GET /api/v1/countries加载目录，然后把各 ID 保存在配置中，而不是按显示名称匹配。 - 每次下单之前，请求
GET /api/v1/prices?country=bs&service=<id>。响应包含当前价格，并告诉你此刻线路是否开放，因为可用性会在一天之中变化。 - 使用
POST /api/v1/activations创建激活，请求体为{"service": "<id>", "country": "bs"}。你会得到一个激活 ID 和一个 +1 242 号码。 - 把该号码输入被测产品的注册或登录步骤。
- 通过 Webhook 等待验证码，或轮询
GET /api/v1/activations/{id}。用POST /api/v1/activations/{id}/cancel干净地放弃一次运行。
一个账户最多可持有 10 个密钥，并每分钟发送 300 次请求，所以预发布环境、CI 和同事的笔记本电脑可以各自拥有独立的密钥，并可单独撤销。这套短信验证 API 的参数和响应都列在 API 文档中。
如何校验 +1 242 验证码的签名 Webhook？
单次手动检查用轮询就够了；一旦多个测试套件并行运行，推送投递会更整洁。在开发者控制台最多注册 5 个端点，并订阅 activation.sms_received、activation.expired 和 activation.cancelled。
每次投递都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。把被签名的字符串重建为 <t>.<raw body>，使用端点密钥对其运行 HMAC-SHA256，并用恒定时间函数将结果与 v1 比较。请对原样到达的字节进行处理；重新序列化解析后的 JSON 会改变空白字符，摘要就不再匹配。拒绝超过几分钟的时间戳，这样被截获的请求就无法被重放。
以激活 ID 作为处理程序的键并使其具备幂等性，因为重试的投递不应让某个测试被标记为通过两次。关于用 HMAC 保护 OTP Webhook 的文章涵盖了时钟偏差和密钥轮换。
巴哈马线路上有哪些服务？员工可以手动下单吗？
巴哈马线路目前列出了超过 900 项服务。热门选择包括 WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、X (Twitter)、ChatGPT (OpenAI)、Microsoft & Outlook、Amazon、Discord、LinkedIn、Uber、Airbnb 和 Signal。请把这份列表视为快照；下单时 API 的响应才是准确的依据。
从不碰密钥的同事在浏览器里也能得到同样的结果。登录，打开 OTP Gateway，选择巴哈马和服务，查看显示的价格并下单。巴哈马验证号码会连同倒计时一起出现，验证码到达时会显示在同一个页面上。
20 分钟窗口内会发生什么？如果什么都没到达怎么办？
每个激活保持 20 分钟有效。如果这段时间内有短信到达，你就按标价付费；如果窗口结束时仍为空，或你提前取消，全部金额会自动退回你的钱包。
当巴哈马验证码没有出现时：
- 在把测试判定为失败之前，先让窗口走完；有些发送方会让消息排队。
- 稍后重试，或通过另一条服务线路重试，因为库存和发送方行为会在一天之中变化。
- 检查该服务是否接受虚拟号码。有些服务会拒绝，这正是设置退款的原因。
- 避免在紧凑循环中重复下单。请在两次尝试之间退避，以免一个不稳定的测试耗尽你的请求额度。
更多排查模式汇总在减少 OTP 投递失败中。
+1 242 号码应该如何存储和规范化？
巴哈马属于北美编号计划，所以它的号码与美国和加拿大共用国家代码 1。完整号码由 1、区号 242 和七位用户号码组成；以 E.164 表示就是 +1242 后接七位数字，共十一位数字。居民常常只说七位本地数字，而编号计划内其他地方的主叫方则会在 242 之前拨一个 1。
这对你的代码有两点影响。仅凭 +1 推断国家的校验器会把巴哈马用户标记为美国用户，所以请检查区号，或使用了解 NANP 地区的编号库。并且请以 E.164 存储每个号码，仅在显示时格式化，使查询和去重保持一致。巴哈马号码上的验证短信通常是英语，这是官方语言，因此本地化检查可以专注于号码格式和国家标签，而不是翻译文案。
产品团队为什么要针对巴哈马测试注册流程？
旅游业、酒店业和金融服务业承载着巴哈马经济的大部分，因此预订平台、打车和配送应用、支付产品，以及拥有加勒比客户的银行，都需要为 +1 242 用户提供一条可用的路径。用于测试的 +1 242 号码，能让 QA 工程师确认表单接受该号码，国家选择器显示的是巴哈马而不是把它并入美国，以及短信同意条款的措辞渲染正确。良好的 OTP 路由还意味着为每个测试用例选择正确的国家，而不是默认使用大陆号码。QA 测试手册展示了如何把它接入自动化测试套件。请把每次检查都限定在你的组织所拥有的账户上，遵守各服务的条款；OTP Route 的《可接受使用政策》适用于所有订单。
可以有巴哈马的长期号码吗？用量如何计费？
巴哈马没有自助开通的长期号码。专属号码（Dedicated Numbers）是美国和加拿大的产品，每月 $1.95 起，支持入站和出站短信、浏览器通话以及 Webhook 转发。如果你的团队需要持续使用的巴哈马号码，请发邮件至 [email protected]；能否实现取决于当地规定，无法承诺。
用量从一个预付费美元钱包中扣除，没有月费，也无需选择套餐。可用银行卡或 USDT/USDC 充值，每次充值都会有一份 PDF 发票发到你的收件箱。做集成开发时，请申请把开发账户切换为沙盒：它会返回模拟的号码和验证码，因此整个流程可以在不动用钱包资金的情况下演练。价格页面展示了费用如何呈现。
常见问题
没有当地 SIM 卡，也能测试我的应用的巴哈马注册流程吗？
可以。在 OTP Gateway 为你要测试的服务订购一个 +1 242 号码，输入到你的流程中，然后在控制台或通过 Webhook 读取验证码。每个验证码 $0.20 起，且仅在短信到达时付费。
API 中巴哈马的国家 ID 是什么？
是 bs。把它传给 GET /api/v1/prices，以及 POST /api/v1/activations 的请求体。
我的手机号库会把 +1 242 当作美国号码吗？
只有在它仅凭国家代码猜测国家时才会。请检查区号，或使用带有 NANP 地区数据的库，使巴哈马号码被正确标注。
如果验证码一直没来，我会被扣费吗？
不会。如果 20 分钟内没有任何内容到达，或你取消，全部金额会自动退回你的钱包。
我能保留巴哈马验证号码以便以后登录吗？
不能作为自助产品提供。长期专属号码仅存在于美国和加拿大；如需巴哈马号码，请发邮件至 [email protected]，团队会告诉你当地规定允许什么。
一个测试套件可以发送多少请求？
每个账户每分钟最多 300 次请求，可分布在最多 10 个 API 密钥上。每隔几秒轮询一次，或改用 Webhook，可以让你稳稳地处于该限制之内。
可以用稳定币为钱包充值吗？
可以。钱包支持银行卡和 USDT/USDC，每次充值都会通过电子邮件附上 PDF 发票。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。