捷克 OTP API 依赖哪些接口？
所有请求都发往 https://otproute.com/api/v1，使用以 or_live_ 开头的 Bearer 密钥。密钥在开发者控制台创建，一个账户最多可持有 10 个，因此可以为预发布环境、CI 和本地笔记本分别配置凭据，并能独立吊销。速率限制为每个账户每分钟 300 次请求。
一次典型的 +420 流程如下：
- 每次部署时获取一次
GET /api/v1/countries和GET /api/v1/services并缓存。捷克的国家 id 是cz。 - 用
GET /api/v1/prices?country=cz&service=<id>查询你准备使用的线路的实时价格；价格随服务和库存而变化。 - 用
POST /api/v1/activations创建激活，JSON 请求体为{"service": "<id>", "country": "cz"}。响应会给出激活 id，以及要填入待测注册表单的号码。 - 通过 Webhook，或以适度的间隔读取
GET /api/v1/activations/{id}来等待验证码。 - 如果测试中止，用
POST /api/v1/activations/{id}/cancel释放号码，冻结的金额会立即回到钱包。
在大型测试集开始之前先调用一次 GET /api/v1/balance，是钱包余额不足时快速失败的低成本办法。完整参考见文档。
如何验证 +420 激活的 Webhook？
Webhook 省去了轮询，适合并行的测试执行器。把你的一个端点（开发者控制台每个账户允许 5 个）指向捷克流程，并订阅 activation.sms_received、activation.expired 和 activation.cancelled。
每个请求都带有 X-OTPRoute-Signature 请求头，格式为 t=<unix>,v1=<hex>。请用未经改动的请求字节重建 <t>.<raw body> 字符串，用该端点的密钥计算 HMAC-SHA256，以恒定时间方式与 v1 比较，并丢弃时间戳过旧、不可能是新投递的请求。我们的指南用 HMAC 保护 OTP Webhook 逐行讲解了一个处理程序。
请把事件视为以激活 id 为键，并让处理程序具备幂等性：重试投递时应发现该激活已标记为完成，直接返回成功即可。对于运行环境里没有公网端点的脚本，轮询 GET /api/v1/activations/{id} 仍是可行的备用方案。
哪些服务可以向捷克号码发送验证码？
捷克线路目前覆盖 1,700 多项服务。最新快照中的热门服务包括 WhatsApp、Telegram、Google (Gmail & YouTube)、Facebook、Instagram、TikTok、Microsoft & Outlook、LinkedIn、Discord、Uber、Airbnb、Signal、Viber 和 ChatGPT (OpenAI)。
这份名单并非固定不变。库存在一天中不断变动，所以代码应在运行时从 API 读取可用性，而不是依赖写死的表格。如果某一时刻缺少你需要的服务，它可能稍后重新出现，也可以考虑使用邻近的中欧线路来满足测试用例。
捷克验证号码应如何存储与解析？
捷克的编号方案是封闭的：国内号码为九位数字，没有中继前缀，因此国内格式和国际格式的区别只是前面的 +420。这让规范化比许多市场简单，但表单仍可能收到空格、00420 国际前缀或只有九位数字的输入。请去掉分隔符，把 00 转换为 +，缺少时补上 +420，然后以 E.164 格式存储。
面向捷克的应用发来的验证码通常是捷克语或英语。捷克语文本带有 háček 和 čárka 等变音符号，有些发送方为了保持纯字符集会去掉它们，所以解析器应查找数字组，而不是匹配完整句子。
团队使用 +420 号码做测试，通常是在为捷克客户上线产品、检查捷克语的引导文案，或确认区域性注册流程接受不带前导零的号码。QA 测试页面概述了团队如何安排这些测试。
捷克验证码一直没到时应该怎么办？
有些服务会拒绝虚拟号码，有些线路在特定时段较慢。没收到验证码不会产生任何费用：如果 20 分钟窗口内没有短信到达，或者你先行取消，全部金额会自动退回钱包。
- 先让窗口走完，再判断这次尝试是否失败。
- 检查你测试的服务是否接受虚拟号码。
- 稍后重试，或换用该服务支持的其他国家线路。
- 两次尝试之间留出间隔；在短时间内反复下单只会消耗速率限制，很少有帮助。
- 每次失败都记录激活 id，这样可以在多次运行中发现规律。
非开发人员能在控制台使用 +420 线路吗？
可以。使用邮箱和 6 位邮件验证码（或 Google 登录）注册后，打开 OTP Gateway，选择服务和捷克，核对显示的价格并下单。捷克验证号码会立刻出现；把它粘贴到应用里，验证码到达时会显示在同一个页面上。在控制台取消订单，与调用 API 取消一样，金额会同样退回钱包。
有捷克的长期号码吗？账单如何处理？
目前没有自助开通的捷克长期号码。专属号码是仅限美国和加拿大的产品，每月 $1.95 起，包含收发短信和浏览器通话；详情见虚拟号码。如果你的团队需要一条长期使用的 +420 线路，请发邮件至 [email protected] 咨询，但请理解，能否提供取决于当地规定，我们不作承诺。
计费采用一个预付费美元钱包，没有月费，也无需选择套餐。可通过银行卡或 USDT/USDC 充值，每笔充值都会通过邮件发送 PDF 发票。做集成开发时，可应要求把开发账号切换为沙盒模式，用模拟的号码和验证码跑通整个流程，不会动用钱包资金。账户本身还可启用 TOTP 双重验证登录。
常见问题
没有捷克 SIM 卡，也能测试我的应用的捷克注册流程吗？
可以。在 OTP Gateway 为你要测试的服务订购一个 +420 号码，填入你的应用，然后从控制台、API 或 Webhook 读取验证码。
捷克在 OTP Route API 中的国家 id 是什么？
在 POST /api/v1/activations 的 country 字段以及价格查询中使用 cz。
捷克验证码的价格是多少？
验证码从每条 $0.20 起，各服务的确切价格由 GET /api/v1/prices 返回，并在下单前显示。只有验证码到达时才会收费。
捷克号码需要前导零吗？
不需要。捷克号码没有中继前缀，请存储为 +420 加九位国内数字。
+420 激活会保持多久？
二十分钟。如果这段时间内没有收到任何内容，激活会过期，钱包全额退款。
面向捷克的 OTP 路由适合批量创建账号吗？
不适合。OTP Route 用于测试你自己的产品和运营你自己的合法账号。每个 +420 激活都应与你自己的产品或账号相关，并遵守各服务的条款以及 OTP Route 的《可接受使用政策》。
我可以保留同一个捷克号码以便日后登录吗？
无法自助开通。长期的专属号码只在美国和加拿大提供，其他市场可以发邮件给支持团队咨询。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。