一次哈萨克斯坦 OTP 运行会用到哪些接口?
完整的一轮包含五到六个请求,发往 https://otproute.com/api/v1,使用以 or_live_ 开头的 Bearer 密钥签名。哈萨克斯坦的国家 id 是 kz,一个账号最多可拥有 10 个密钥,因此 CI、预发布环境和开发者笔记本可以各自拥有自己的密钥。
- 在任务开头调用
GET /api/v1/balance,让余额不足的钱包尽早使运行失败。 - 用
GET /api/v1/prices?country=kz&service=telegram读取该组合的当前价格和可用性。 - 用
POST /api/v1/activations加{"service": "telegram", "country": "kz"}下单,它会返回 activation id 和一个 +7 号码。 - 如果你选择轮询,就调用
GET /api/v1/activations/{id};如果依赖 Webhook,则完全不需要。 - 当测试在需要验证码之前退出时,调用
POST /api/v1/activations/{id}/cancel。
限额为每个账号每分钟 300 次请求,足以容纳每隔几秒轮询一次的并行任务。如果这是你的第一次构建,请从 API 集成指南开始。
如何通过 Webhook 而不是轮询来获取 +7 验证码?
在开发者控制台注册一个端点(每个账号五个),并订阅 activation.sms_received、activation.expired 和 activation.cancelled。每个 POST 请求都带有 X-OTPRoute-Signature: t=<unix>,v1=<hex>。
使用端点密钥对 <t>.<raw body> 重新计算 HMAC-SHA256 签名,并以恒定时间进行比较。请使用收到的原始字节,因为重新序列化的 JSON 会产生不同的摘要,并拒绝超出短暂容差的时间戳以防止重放。由于投递可能被重试,请基于 activation id 做 upsert,让第二份副本不产生任何改变。基于 Webhook 的 OTP 捕获中有分步讲解。
哪些应用可以向哈萨克斯坦号码发送验证码?
kz 线路列出了超过 1,700 种服务。最新快照中的热门服务包括 Telegram、WhatsApp、Google(Gmail 和 YouTube)、Instagram、TikTok、Facebook、Viber、Discord、Microsoft 和 Outlook、LinkedIn、Uber、AliExpress 以及 Amazon。
不要把这份列表固化在代码里。线路在一天中会变化,所以脚本应当在每次下单之前检查 GET /api/v1/prices,并在某个组合不可用时选择备用的服务 id。
为什么 +7 在手机号数据库中需要格外小心?
哈萨克斯坦与俄罗斯共用国家代码 7。两国都使用十位的国内号码,哈萨克斯坦的手机号段在国家代码之后通常以 7 开头,所以像 +7 7xx xxx xx xx 这样的号码是哈萨克斯坦的,而许多俄罗斯手机号以 9 开头。切勿仅凭拨号代码推断国家;请借助持续维护的号码库按号段来判断,或者保留一个明确的国家字段。
在国内,人们会在十位数字前面拨一个中继前缀 8。输入时请将其去掉,并存储 E.164 格式,即 +7 加国内号码。哈萨克语是国家语言,俄语在官方场合也被广泛使用,因此验证短信可能以俄语、哈萨克语或英语送达,通常使用西里尔字母。请确保你的短信解析器和日志能处理 UTF-8,并提取数字而不是措辞。
团队在这里测试的情形包括:进入中亚市场、检查双语本地化,或为区域运营人员提供支持。
不写代码的团队有控制台方式吗?
有。使用邮箱验证码或 Google 注册后,给钱包充值,选择哈萨克斯坦和服务,确认显示的价格并下单。+7 号码以及稍后的验证码都会显示在激活卡片上。产品经理和本地化测试人员用它做抽查,而流水线负责处理大批量。
哈萨克斯坦号码可以保留用于重复登录吗?
没有自助方式可以做到这一点。OTP Gateway 号码只服务于一个验证码,而长期专用号码仅面向美国和加拿大销售,起价 $1.95/月,支持收发短信以及浏览器通话。如果你需要长期使用的哈萨克斯坦线路,请发邮件到 [email protected];能否安排取决于当地规定,无法保证。对于需要再次登录的预发布账号,如果服务接受,美国或加拿大线路往往是切实可行的办法。
20 分钟内没收到验证码会怎样?
激活过期,Webhook 触发 activation.expired,全部金额无需你做任何操作即退回钱包。重试之前先排查:
- 提交号码时用的是
+7,而不是国内的 8 吗? - 该服务是否拒绝虚拟号码?有些会拒绝,这就是 OTP Route 会退还未使用激活的原因。
- 稍后重试或换一条线路,而不是立刻循环;短暂的退避能让你的日志保持清晰。
投递速度取决于服务和线路,所以测试中避免使用过紧的超时。
账号如何计费?
单一的预付美元钱包,按用量付费,没有订阅,也没有套餐等级。可通过银行卡或 USDT、USDC 稳定币充值;每次充值和号码购买都会通过邮件生成 PDF 发票。开发账号可应要求切换到沙盒模式,返回模拟的号码和验证码用于端到端测试。请将该服务用于你自己的合法产品,遵守各应用的条款以及《可接受使用政策》,实时费率请参阅定价。
常见问题
如何区分哈萨克斯坦的 +7 号码和俄罗斯的号码?
要看号段,而不只是国家代码。哈萨克斯坦的手机号在 +7 之后通常以 7 开头;使用持续维护的号码库或明确的国家字段可以避免出错。
哈萨克斯坦在 OTP Route API 中的国家 id 是什么?
在激活请求体以及价格接口的 country 参数中使用 kz。
没有当地 SIM 卡,我能测试应用的哈萨克斯坦注册流程吗?
可以。从 OTP Gateway 订购哈萨克斯坦的 +7 号码,输入到你自己的流程中,然后通过 Webhook、轮询或控制台获取验证码。
如果 Telegram 验证码一直没到,我会被收费吗?
不会。如果 20 分钟窗口内没有短信,或者在取消之后,金额会自动退回你的钱包。
哈萨克斯坦的验证短信是俄语还是哈萨克语?
两者皆有可能,有些服务还使用英语。请解析数字验证码,并确保你的技术栈能处理西里尔字母文本。
哈萨克斯坦线路有月费吗?
没有。OTP Route 按用量付费,使用通过银行卡、USDT 或 USDC 充值的预付美元钱包。
服务名称均为其各自所有者的商标，OTP Route 与其无任何关联。请合法使用号码，并遵守各服务的条款及我们的可接受使用政策。