OTP 验证 API
针对转售商
通过一个 REST API 以每个 0.10 美元起的价格转售一次性短信验证号码。即时开通，未使用激活可全额退款，并提供签名的 Webhook —— 在真实运营商号码的基础上构建你自己的 OTP 平台。
一个 API 满足你所有一次性短信验证需求
免费的公共短信收件箱是公开可读的，并且已经被每个平台标记。为一次性使用然后丢弃的号码建立自己的运营商关系成本很高。
VRNUM OTP API 随需提供一个实时的、私密的真实运营商号码池。开通一个号码，接收验证码，该号码永远不会显示给其他人 — 并且你展示的每个价格中已经包含了你的加价。
从订单到验证码验证
四个调用即可涵盖整个 OTP 生命周期。
查看目录
GET /otp-catalog 获取实时服务、国家和价格——在展示给客户之前可应用您的加价。
订购号码
POST /otp-numbers，包含服务、国家和幂等键。号码会立即返回。
获取验证码
GET /otp-numbers/:id 实时检查短信，或者等待 otp.completed webhook 事件。
重发或退款
还没有验证码？尝试 /resend，或者 /cancel 即可立即将全额退款到你的钱包。
一次请求订购 OTP 号码
clientReference 是你自己的不透明 ID——将其附加以便与内部客户记录对账。
curl -X POST https://vrnum.com/api/v1/otp-numbers \
-H "Authorization: Bearer vrnum_live_..." \
-H "Content-Type: application/json" \
-H "Idempotency-Key: otp-5521" \
-d '{
"service": "whatsapp",
"countryCode": "us",
"clientReference": "otp-5521"
}'完整的 OTP 订单生命周期
目录、订购、重发、取消/退款以及 Webhooks——一个一致的 JSON API。
/api/v1/otp-catalog/api/v1/otp-numbers/api/v1/otp-numbers/api/v1/otp-numbers/:id/api/v1/otp-numbers/:id/resend/api/v1/otp-numbers/:id/cancel/api/v1/webhook/api/v1/balanceFull request/response docs and your keys live in your dashboard after you sign in.
Who builds on the OTP verification API
Any product that needs a real phone number for a single verification step.
SMS verification platforms
Resell OTP numbers to your own customers under your brand, with your own markup on every service.
QA & test automation
Create disposable test accounts on production services without burning personal phone numbers.
Bot & agency tooling
为为客户构建的账户创建工作流以编程方式分配号码。
开发者工具
在您自己的应用或 SDK 中提供“通过短信验证”功能，而无需拥有电信基础设施。
可靠到足以向自己的客户计费
幂等键
超时安全重试——相同的幂等键始终返回原始订单，绝不会产生重复。
签名 Webhook
otp.completed、number.provisioned 和 number.provisioning_failed 事件，均使用 X-VRNUM-Signature 签名。
自动重试
失败的 webhook 推送将按回退计划重试（5分钟、30分钟、2小时、6小时、24小时），随后我们才会放弃。
透明的速率限制
每个密钥每分钟 60 次请求，每个响应都包含 X-RateLimit-* 头。
钱包资助的计费
没有发票或订阅——订单和退款会在发生的瞬间计入您的余额。
稳定的错误代码
每个错误都会返回一个标准化的 JSON 代码，您的集成可以可靠地根据它进行处理。
常见问题
我可以通过 VRNUM API 转售 OTP 号码吗？
可以。otp-catalog 和 otp-numbers 端点仅返回您的转售价。可以针对每项服务和每个国家设置自己的利润——您的客户永远看不到 VRNUM 的内部成本。
如果 OTP 代码从未到达会发生什么？
在仍然等待激活的情况下，调用 POST /otp-numbers/:id/cancel 可将全额退款退回到您的钱包。您也可以先调用重发端点。
通过 API，OTP 激活的有效期是多少？
每次激活从创建起有效 20 分钟。如在未收到验证码前取消，可全额退款。
如何避免在重试时对客户重复收费？
在 POST /otp-numbers 请求中发送 Idempotency-Key 头。使用相同的键重试相同请求会返回原始订单，而不会创建新订单。
我能实时获取交付事件，而不是轮询吗？
可以。注册一个 webhook 端点，并在事件发生时接收签名的 otp.completed 事件，而无需轮询。
API 支持哪些服务？
超过 80 个服务，包括 WhatsApp、Telegram、Google、Instagram、Facebook、Discord 等。调用 GET /otp-catalog 获取实时列表。