为什么团队要把黑山加入测试矩阵？
黑山是亚得里亚海沿岸的小型市场，却经常出现在产品路线图上。面向西巴尔干地区上线的产品，通常会把它与塞尔维亚、波斯尼亚和黑塞哥维那以及克罗地亚一起发布，因为这些国家的语言相近，一次本地化工作就能覆盖多个国家。旅游、订房和打车类应用关注沿海的度假旺季，而在海外拥有黑山用户的公司，则想了解 +382 用户在注册时会遇到什么。
黑山语是官方语言，塞尔维亚语、波斯尼亚语、阿尔巴尼亚语和克罗地亚语也在官方场合使用，短信可能采用拉丁字母或西里尔字母。有了黑山验证号码，QA 就能在真实用户接触手机验证步骤之前，确认它运行正常。
+382 手机号如何书写，系统里该怎么存储？
在国内，黑山号码带有前缀 0，手机号拨打时为 06x 加上另外六位数字。去掉 0 之后的国内号码共八位。要生成 E.164 格式，去掉 0 并加上国家代码，本地的 06x xxx xxx 就变成 +3826x xxx xxx（存储时不带空格）。
对你自己的系统，可以遵循以下实用规则：
- 接受带或不带 0 的输入，保存前先做规范化。
- 只存储标准的
+382…字符串，仅在界面边缘做显示格式化。 - 不要把手机号段硬编码成有效性校验，因为号段可能被重新分配，用户也会在运营商之间携号转网。
黑山的 OTP 短信会用什么语言？
大多数全球性应用会用英语或用户在应用内选择的语言发送验证码。若服务针对该地区做了本地化，预计会看到拉丁字母的黑山语或塞尔维亚语，偶尔也有西里尔字母，后者会以 Unicode 短信发送。你的提取逻辑应当查找数字序列，而不是固定的措辞，这样发送方修改模板时，原本通过的测试就不会失败。
`me` 路由上有哪些服务可用？
当前快照显示黑山有超过 1,400 个服务。常用的包括在西巴尔干地区广泛使用的 Viber，以及 WhatsApp、Telegram、Instagram、Facebook、Google（Gmail 和 YouTube）、TikTok、Snapchat、Signal、LinkedIn、Discord、Amazon、Airbnb 和 Uber。
某一时刻提供哪些服务取决于我们的运营商合作伙伴，并会在一天中变化，所以请通过 GET /api/v1/services 获取实时列表或查看控制台，不要长期缓存。
如何通过短信验证 API 接收黑山的 OTP？
在开发者控制台创建一个 Bearer 密钥（前缀为 or_live_），然后：
- 用
GET /api/v1/prices?country=me&service=<id>读取当前价格。 - 用
POST /api/v1/activations下单，请求体类似{"service": "viber", "country": "me"}。 - 在你的 Webhook 上接收
activation.sms_received事件，或以适度的间隔轮询GET /api/v1/activations/{id}。 - 用
POST /api/v1/activations/{id}/cancel取消未使用的订单。
请检查每次推送的 X-OTPRoute-Signature 请求头：用端点密钥对时间戳、一个点号和原始请求体计算 HMAC-SHA256，进行比对，并丢弃过期的时间戳。让处理程序以激活 id 为键，这样重复推送只会被处理一次。HMAC Webhook 指南和 API 文档有更多细节；每个账户最多可有 10 个密钥、5 个 Webhook 端点，每分钟 300 次请求。
控制台怎么操作？收不到验证码怎么办？
非开发人员也能获取 +382 测试号码：在控制台选择黑山和服务，查看价格后下单，然后在 +382 号码旁边等待验证码出现。
每次激活持续 20 分钟。只有验证码送达才会收费；窗口到期仍无短信，或你主动取消，全额退回钱包。如果验证码没到，请让窗口走完整个时长，确认该服务接受虚拟号码，然后稍后重试，或换用其他服务路由，不要快速循环重复下单。
可以长期保留黑山号码吗？如何付款？
目前没有自助的长期 +382 线路。专属号码（Dedicated Numbers）仅限美国和加拿大，$1.95/月起；如需长期使用的黑山号码，可以发邮件至 [email protected] 咨询，但能否提供取决于当地法规。
OTP Route 使用预付费美元钱包，没有订阅。可通过银行卡或 USDT/USDC 充值，每次充值都会收到 PDF 发票。开发账户可申请沙盒模式，使用模拟号码进行端到端测试。请仅将号码用于你自己的产品和账户，遵守各服务的条款，并记住《可接受使用政策》同样适用。
常见问题
没有黑山 SIM 卡，能接收 +382 验证码吗？
可以。OTP Gateway 会为一次验证分配一个黑山号码，验证码会显示在控制台，或通过 API 送达你的系统。
存储黑山号码时应该保留开头的 0 吗？
不应该。0 是国内的长途前缀；请保存以 +382 开头的 E.164 格式，只有在需要本地显示时才把 0 加回去。
黑山在 API 中的国家 id 是什么？
是 me，用于价格查询和激活请求体。
黑山验证号码多少钱？
每条验证码 $0.20 起，具体黑山服务的价格由价格接口返回，所以脚本可以在每次下单前先查询。
如果 Viber 或其他应用没有发送短信，+382 订单会退款吗？
20 分钟窗口结束仍无短信，或你立即取消时，会全额退回你的钱包。
能用黑山号码测试西里尔字母的 OTP 短信吗？
只有当你测试的服务选择发送西里尔文本时才可以；内容由发送方决定。请把解析器写成能从任何文字中提取数字。
黑山的 OTP 路由可以用在 CI 流水线里吗？
可以。许多团队从测试运行器通过 API 下单；参阅 CI 中的 OTP 测试，了解避免重试不稳定的做法。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。