你需要的是只收一个验证码的 +34 号码，还是长期保留的西班牙线路？
从这里开始，因为它决定了你该打开哪个产品。我们见到的几乎所有西班牙相关任务都是一次性的：确认新的注册页面会发送验证码、在版本发布后重跑引导回归测试，或为在西班牙运营的团队验证企业资料。这些都属于 OTP Gateway 的范畴，每个号码的存在只为接收一个验证码。
如果计划是几个月后再登录同一个账户，那么一次性号码就是错误的工具，而且并没有西班牙的替代品可选。自助开通的专属号码只覆盖美国和加拿大，每月 $1.95 起，支持入站短信、出站短信和浏览器通话。西班牙没有自助开通的长期线路；你可以发邮件至 [email protected] 咨询，但能否实现取决于当地规定。
对于不需要西班牙身份的周期性预发布环境登录，通常更干净的答案是虚拟号码页面上的美国或加拿大线路。
西班牙电话号码有什么特别之处？
西班牙不使用冠码。国内号码为九位数字，在国内的拨打方式与写在 +34 之后的方式相同，手机号以 6 或 7 开头。因此在 E.164 格式中，西班牙手机号就是 +34 加以 6 或 7 开头的九位数字，规范化的工作主要是去掉空格、点号，以及部分用户粘贴进来的可选 0034 国际前缀。
在表单测试中值得加入两项检查：以 0034 前缀输入的号码应当与以 +34 输入的号码归一为同一个存储值；如果你的流程需要手机号，则应尽早标出以 9 开头的固定电话。
语言同样重要。西班牙语是国家通用语言，而加泰罗尼亚语、加利西亚语和巴斯克语在各自地区是共同官方语言，所以西班牙用户可能会以这四种语言中的任何一种使用应用。发往 +34 号码的验证短信大多是西班牙语或英语，但你的提取逻辑绝不应依赖周围的词语。
现在哪些服务可以使用西班牙验证号码？
西班牙线路覆盖超过 1,900 项服务。经常被请求的包括 WhatsApp、Telegram、Google (Gmail & YouTube)、Instagram、Facebook、TikTok、Amazon、Airbnb、eBay、Microsoft & Outlook、LinkedIn、Signal、Claude 和 Netflix。
可用性是一个实时值，而不是固定列表。每次运行开始时，请查询 GET /api/v1/countries 以及针对 es 的价格接口，这样暂时缺失的服务就能被干净地跳过。
非开发人员如何在控制台订购西班牙号码？
产品经理、客服负责人和本地化审校人员很少想碰 API 密钥，他们也不必这样做。
- 登录并打开 OTP Gateway。
- 选择西班牙，然后选择你要检查页面的服务。
- 确认之前先查看显示的价格；它因服务而异。
- 把 +34 号码复制到应用中并请求验证码。
- 保持标签页打开；消息文本到达后会出现在激活行中。
许多团队就是这样处理西班牙语版本的偶尔手动检查，或运营部门管理的企业账户的一次性确认。
如何把西班牙 OTP API 接入 CI？
自动化测试套件调用 https://otproute.com/api/v1 下的同一组 REST 接口，使用前缀为 or_live_ 的 Bearer 密钥。西班牙的国家 ID 是 es。
GET /api/v1/prices?country=es&service=<id>返回该组合当天的费用。POST /api/v1/activations，请求体为{"service": "instagram", "country": "es"}，创建订单并返回号码和激活 ID。GET /api/v1/activations/{id}报告状态以供轮询；POST /api/v1/activations/{id}/cancel释放你的测试不再需要的订单。GET /api/v1/balance让流水线在资金不足时提前停止。
对于并行任务，请让 Webhook 端点订阅 activation.sms_received、activation.expired 和 activation.cancelled。通过用端点密钥对 <t>.<raw body> 重新计算 HMAC-SHA256 来确认 X-OTPRoute-Signature 请求头，拒绝过期的时间戳，并按激活 ID 存储结果，这样重试就不会造成影响。我们的基于 Webhook 的 OTP 捕获教程展示了完整的处理程序。限制为每个账户 10 个密钥、5 个端点和每分钟 300 次请求。
西班牙的验证码为什么可能收不到？之后该怎么办？
每次激活开放 20 分钟，只有验证码到达时才付费。已取消的订单，或窗口到期仍未收到短信的订单，都会全额退回钱包，无需提交工单。
当 +34 订单一直为空时，先给它完整的窗口时间。如果仍然失败，最常见的原因是该服务在这个流程里拒绝虚拟号码，而退款规则正是为了应对这种情况。之后，请在不同时间或换一条服务线路再试，并在两次尝试之间加入停顿，以免自动化任务冲击接口。我们的移动应用验证页面讨论了如何设计能容忍这种情况的测试。
在西班牙工作的团队，OTP Route 如何计费？
只有一个以美元计价的预付费钱包，按使用量扣费，没有订阅或档位。团队可以用银行卡或 USDT/USDC 充值，每次充值和号码购买都会通过电子邮件发送一份 PDF 发票，让欧盟的记账更简单。当前费率见价格页面。
集成期间，请为你的开发账户申请切换到沙盒；它会返回模拟的号码和验证码，让西班牙路径可以零成本地端到端测试。OTP Route 用于测试和运营你自己的合法产品与账户：请遵守各服务的条款，并请记住《可接受使用政策》适用于每一笔订单。
常见问题
没有西班牙 SIM 卡，也能检查我的应用的西班牙注册流程吗？
可以。在 OTP Gateway 订购一个 +34 号码并在应用中输入，验证码就会出现在控制台中，也可通过 API 获取。
西班牙的 API 国家 ID 是什么？
是 es，用于 POST /api/v1/activations 和 GET /api/v1/prices 等调用。
西班牙号码有需要去掉的冠码零吗？
没有。西班牙没有冠码，所以九位国内数字直接跟在 +34 后面；只需去掉空格和任何 0034 前缀。
测试用的 +34 号码要多少钱？
每个验证码 $0.20 起。每项服务的实时价格由 API 返回，并显示在控制台中，且只有验证码到达时才付费。
我能租用一个西班牙号码来长期登录吗？
西班牙没有自助开通的选项。长期专属号码仅限美国和加拿大，每月 $1.95 起；如需了解西班牙的情况，请发邮件至 [email protected] 咨询。
验证码会以加泰罗尼亚语或巴斯克语送达吗？
偶尔会有应用按用户所选的语言发送，但最常见的是西班牙语或英语。请提取数字，这样措辞就不会破坏你的测试。
有办法在不花钱包资金的情况下测试吗？
有。为你的开发账户申请沙盒，即可收到模拟的号码和验证码。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。