一次性验证码还是长期线路：新喀里多尼亚项目需要哪一种？
请先做出决定，因为它会影响整个集成的其余部分。
- OTP Gateway 号码用于单次验证。你预留一个 +687 号码，接收一条验证码，然后激活结束。这适合注册测试、本地化检查，以及每次创建新测试账户的 CI 运行。
- 专属号码（Dedicated Numbers） 是续费期间由你持有的线路，支持收发短信和浏览器通话。它们仅在美国和加拿大销售，$1.95/月起，新喀里多尼亚没有对应的自助产品。
如果新喀里多尼亚的线路需要与某个账户绑定数月，请发邮件至 [email protected] 描述你的用例；能否提供取决于当地规定，无法承诺。对于一次只需要一条验证码的场景，网关就是合适的工具。我们对临时号码与专属号码的比较讲得更深入。
新喀里多尼亚路由如何调用 OTP Gateway？
所有请求都发往 https://otproute.com/api/v1，使用以 or_live_ 为前缀的 Bearer 密钥。在开发者控制台生成密钥，每个账户最多 10 个，并按环境轮换。
- 在
GET /api/v1/countries中查找路由；新喀里多尼亚的 id 是nc。 - 从
GET /api/v1/services获取服务 id。 - 向
GET /api/v1/prices?country=nc&service=<id>查询实时价格和可用性。 - 用
POST /api/v1/activations创建激活，请求体类似{"service": "facebook", "country": "nc"}。保存返回的激活 id。 - 在你正在测试的应用中输入 +687 号码。
- 通过 Webhook 接收验证码，或轮询
GET /api/v1/activations/{id}。测试放弃时调用POST /api/v1/activations/{id}/cancel。
在批量运行前调用 GET /api/v1/balance 是值得的，这样钱包为空时运行能快速失败。开发者页面汇集了这个新喀里多尼亚 OTP API 的 SDK 说明和文档。
+687 验证码的签名 Webhook 是什么样的？
最多可注册 5 个端点，并选择你需要的事件：activation.sms_received、activation.expired 和 activation.cancelled。每次推送都会带有格式为 t=<unix>,v1=<hex> 的 X-OTPRoute-Signature 请求头。
要信任一次推送，请用 HMAC-SHA256 和你的端点密钥对 <t>.<raw body> 进行签名，然后以恒定时间与 v1 比对。丢弃任何时间戳过旧的请求。由于同一事件可能被再次发送，请以激活 id 为索引记录已处理的事件并跳过重复。更愿意轮询的团队也可以这样做，只要不超过每分钟 300 次请求的上限。
哪些服务可以接收新喀里多尼亚的短信 OTP？
该路由目前覆盖超过 700 个服务。实时快照包括 WhatsApp、Facebook、Instagram、Google（Gmail 和 YouTube）、Microsoft 和 Outlook、Amazon、Airbnb、Uber、Netflix、Telegram、LinkedIn、Snapchat 和 TikTok。
目录比大型市场小，并且会在一天中变化，所以请始终在下单时从 API 读取可用性。如果缺少某个服务，请稍后再查，或围绕邻近的路由来规划测试。
+687 号码在校验和本地化方面有什么不同？
新喀里多尼亚使用封闭的六位编号计划，没有长途前缀，所以 E.164 格式就是 +687 加六位数字。针对更长国内号码调整过的校验器经常会拒绝它，这使其成为任何电话字段的一个有用边界案例。请存储完整的 E.164 字符串，不要套用其他市场的长度规则。
法语是官方语言，群岛上还使用许多卡纳克语言。预计验证消息为法语或英语，并确保带重音字符的模板在你的日志中能正确显示。该领地使用 UTC+11，且不实行夏令时，如果你的测试对时间戳或过期时间进行断言，这一点很重要。
团队来这里是为了对欧洲以外的法语流程做 QA，为旅游和酒店类产品提供支持，以及验证太平洋地区业务运营的账户。移动应用验证页面介绍了应用团队如何设置这类检查。
非开发人员如何获取新喀里多尼亚验证号码？
控制台无需代码。用邮箱和 6 位验证码，或 Google 注册，并启用 TOTP。给钱包充值，选择新喀里多尼亚和服务，在查看显示的价格后确认。把 +687 号码粘贴到应用中，然后观察该激活，直到验证码出现。
如果 20 分钟内什么都没到怎么办？
只有验证码到达才会收费。窗口在没有短信的情况下到期，或你取消时，全部费用会自动退回钱包。
- 让激活走完它的全部时间；送达速度取决于服务和路由。
- 在稍后的时段重试，或者如果测试允许，改用其他服务路由。
- 弄清该服务是否接受虚拟号码。有些服务会拒绝，这正是退款所要保护你的地方。
- 避免快速循环重新下单；请间隔尝试，并记录每个激活 id。
新喀里多尼亚的测试如何计费？
所有费用都从一个预付费美元钱包中扣除。没有月费，也不用选择套餐。可通过银行卡或 USDT/USDC 充值，每次充值都会通过邮件发送 PDF 发票。对于集成工作，可为开发账户申请沙盒模式，以获取模拟的号码和验证码，不会消耗钱包资金。
OTP Route 用于测试和运营你自己合法的产品和账户。太平洋市场的测试同样受各服务自身条款以及我们的《可接受使用政策》约束。
常见问题
没有本地 SIM 卡，也能测试新喀里多尼亚的注册流程吗？
可以。从 OTP Gateway 订购一个 +687 号码，在你的应用中使用，并在控制台或通过 API 读取验证码。
新喀里多尼亚的 API 国家 id 是什么？
是 nc，在价格查询和激活请求体中都使用它。
新喀里多尼亚的电话号码有多长？
+687 国家代码之后为六位数字，没有长途前缀。以 E.164 格式存储，不要套用其他国家的长度规则。
用于测试的 +687 号码多少钱？
每条验证码 $0.20 起，具体每个服务的实时价格会在下单前由 GET /api/v1/prices 返回。
可以租用长期的新喀里多尼亚号码吗？
那里没有自助选项；长期专属号码仅限美国和加拿大。你可以发邮件至 [email protected] 咨询新喀里多尼亚线路。
新喀里多尼亚的 OTP 短信会用什么语言？
通常是法语或英语，取决于服务。请解析数字验证码，这样两种语言都能处理。
如果验证码一直没来，+687 订单会退款吗？
会，20 分钟窗口结束或你取消时，钱包会自动收到全额退款。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。