一次 +351 验证会调用哪些接口？
基础 URL 为 https://otproute.com/api/v1，每个请求都需携带以 or_live_ 开头的 Bearer 密钥。葡萄牙的国家 id 是 pt。
GET /api/v1/countries与GET /api/v1/services返回各类 id，建议在每次测试运行中缓存。GET /api/v1/prices?country=pt&service=<id>返回当前价格以及该线路是否开放。POST /api/v1/activations，请求体为{"service": "telegram", "country": "pt"}，用于预留号码并返回激活 id。- 如果你更习惯轮询，
GET /api/v1/activations/{id}会返回状态和验证码。 POST /api/v1/activations/{id}/cancel用于释放测试中不再需要的号码。GET /api/v1/balance可让流水线在钱包余额不足时提前停止。
账户限制为 10 个 API 密钥、5 个 Webhook 端点，以及每分钟 300 次请求。完整的数据结构见 API 参考。
签名 Webhook 如何把葡萄牙验证码送到我们的服务？
在开发者控制台注册一个 HTTPS 端点，并订阅 activation.sms_received、activation.expired 和 activation.cancelled。每个 POST 请求都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。
验证方法：重新拼出字符串 <t>.<raw body>，用端点密钥计算 HMAC-SHA256，再以恒定时间比较方式与 v1 对照。时间戳过旧的请求应直接拒绝，避免被截获的请求遭到重放。记录每个事件中的激活 id，遇到重复就忽略，这样即使投递被重试，处理程序也是安全的。具体做法可参阅 基于 Webhook 的 OTP 捕获，里面有分步讲解。
葡萄牙线路上有哪些服务可用？
在当前快照中，葡萄牙可用的服务超过 2,000 个。常用的包括 WhatsApp、Telegram、Airbnb、Uber，以及 Google（Gmail 和 YouTube）、Facebook、Instagram、TikTok、LinkedIn、Microsoft 和 Outlook、Amazon、Netflix、Discord 与 Signal。
可用服务集合会随着我们的运营商合作伙伴调整容量而在一天中变化。因此，决定某项测试是否运行，应当依据价格接口，而不是一份静态配置文件。
产品团队为什么要用葡萄牙号码做测试？
在欧洲的上线计划中，葡萄牙经常排在较前的位置。里斯本和波尔图聚集了不少产品与工程团队，许多公司也把葡萄牙作为欧洲基地。此外还有本地化方面的原因：欧洲葡萄牙语（pt-PT）与巴西葡萄牙语在拼写、词汇和称呼方式上都有差异，按巴西葡萄牙语翻译的流程，在葡萄牙用户看来可能显得别扭。通过真实的 +351 验证，评审人员可以把 pt-PT 文案、实际收到的短信以及前后页面放在一起检查。
在 GDPR 框架下，让员工的手机号码远离测试账户和共享账户，也是良好的数据最小化实践。每次检查使用一个一次性号码，意味着你的 QA 系统里留存的个人标识更少。CI 流水线指南 介绍了如何把这一步纳入每一次构建。
+351 号码如何格式化和存储？
葡萄牙没有国内长途前缀：号码共九位，国内拨打与国际格式（+351 之后）的号码相同。手机号以 9 开头，固定电话的区号以 2 开头。请以 E.164 格式存储，凡国家代码之后不是九位数字的一律拒绝，并去掉用户按每三位分组输入时添加的空格。
收到的验证码通常使用葡萄牙语或英语，具体取决于发送方和账户所设语言。你的验证码提取逻辑应当识别数字，而不是依赖固定的措辞。
同事不写代码也能操作吗？收不到短信怎么办？
在控制台中打开 OTP Gateway，选择葡萄牙和一个服务，确认实时价格后下单。把号码粘贴到你的应用里，然后在激活页面等待验证码即可。
窗口期为 20 分钟，只有验证码到达才会扣费；否则全额金额会自动退回钱包。如果没有收到验证码：
- 让窗口期自然结束，不要几秒钟后就取消。
- 确认该服务在对应流程中接受虚拟号码。
- 稍后重试，或用另一个服务线路测试同一个页面。
- 两次尝试之间适当退避，不要在紧凑的循环里反复下单。
有葡萄牙专属号码吗？计费方式是什么？
OTP Route 在葡萄牙不提供自助购买的专属号码。专属虚拟号码仅适用于美国和加拿大，每月 $1.95 起；如果需要长期使用的 +351 号码，请发送邮件至 [email protected]，但需要说明的是，能否提供取决于当地规定，并不能保证。想了解两者区别，请看 临时号码与专属号码有何不同。
付款方式为按量付费，使用预付美元钱包，没有月费，也无需选择套餐，可通过银行卡或 USDT/USDC 充值，每次充值都会附带 PDF 发票。开发账户可应要求切换到沙盒环境，用模拟的号码和验证码进行测试。请遵守各服务的条款；OTP Route 的《可接受使用政策》同样适用。
常见问题
OTP Route API 中葡萄牙的国家 id 是什么？
是 pt，在价格查询和激活请求体中都使用它。
葡萄牙手机号有像开头 0 这样的国内长途前缀吗？
没有。葡萄牙号码为九位数字，没有国内长途前缀，因此 E.164 格式是 +351 加这九位数字。
没有葡萄牙 SIM 卡，能测试 pt-PT 的注册流程吗？
可以。来自 OTP Gateway 的 +351 测试号码会接收验证码，你可在控制台或通过 API 读取。
葡萄牙验证号码要多少钱？
每条验证码 $0.20 起；具体价格取决于服务，下单前会显示。
如果 +351 的激活没有收到任何内容，我还要付费吗？
不用。已过期或已取消的激活会全额退回你的钱包。
我能租用葡萄牙号码来长期登录吗？
不能自助购买。长期号码仅限美国和加拿大；如果需要 +351 号码，请发邮件联系支持团队。
接收葡萄牙验证码应该用轮询还是 Webhook？
并行任务较多时 Webhook 更易扩展，而无法接收入站流量的运行环境更适合轮询 GET /api/v1/activations/{id}。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。