长期号码
读取目录 → 确认当前价格 → 用保存好的幂等键购买 → 查询订单和收到的短信。在实际有效期内接收所选服务的短信；延长已有订单前，先查询普通续费资格。
开发者 API · 长期号与临时号
使用 Vozira 构建虚拟号码与短信工作流
使用同一个 Vozira 账户、钱包和 API 密钥，为目录中的服务购买长期号或临时号，查询订单并读取收到的短信。符合条件的长期订单还可普通续费。价格、库存和有效期以当前目录、报价和实际订单为准。
用于购买收件号码、读取验证码的 API
从 Vozira 选择号码，读取自己订单实际收到的短信。目标服务决定是否接受号码、是否发出验证码。Vozira 提供收件号码访问能力，这套 API 不向你的客户手机号发送 OTP 短信。
统一接口地址为 https://vozirasms.com/api/v1。在 Vozira 账户的 API Access 中生成密钥，由服务端代码通过 X-Api-Key 请求头发送。选购、订单和短信查询均通过 Vozira 本站域名访问。
选择需要的接入流程
临时号码
选择目录中的服务和国家 → 获取报价 → 用保存好的幂等键确认报价 → 查询订单中的短信、到期时间及退款状态。临时号购买需要普通 Vozira 账户。
共用网站钱包
购买前查询余额。API 成功购买会实际扣除 Vozira 钱包余额；充值通过本站充值页面完成，充值本身不会购买号码。目前没有公共沙箱。
明确确认价格，安全处理重试
长期号购买携带当前目录价格对应的 expected_total；临时号先核对报价，在报价到期前确认返回的 quote_id。每次购买前保存一个独立的 Idempotency-Key，仅对完全相同的请求复用原键。
发生超时或结果未知时，使用保存的原键查询原操作，不因为没有收到响应就换键重新购买。状态与重试规则见完整文档。
先用只读请求接入
在服务端代码中将 YOUR_KEY 替换为自己的密钥。以下示例只查询余额和目录，不购买或续费号码。
读取余额
curl https://vozirasms.com/api/v1/balance \
-H "X-Api-Key: YOUR_KEY"读取长期号目录
curl https://vozirasms.com/api/v1/apps \
-H "X-Api-Key: YOUR_KEY"读取临时号服务
curl 'https://vozirasms.com/api/v1/one-time/catalog?service=Telegram' \
-H "X-Api-Key: YOUR_KEY"妥善保管密钥
使用 HTTPS 和 X-Api-Key 请求头。密钥不能放进浏览器 JavaScript、查询字符串、公开截图或公共代码仓库。可在 API Access 中轮换或撤销。
轮询读取短信
v1 没有开发者回调推送；通过订单查询读取短信和状态。短信轮询间隔至少五秒；连续没有短信时退避到 10–15 秒。HTTP 429 时遵守 Retry-After。
临时号取消与退款
购买满两分钟且未收码，可申请取消；取消确认成功后，原购买金额退回 Vozira 站内余额。20 分钟到期且本站未收到验证码时，原购买金额退回站内余额一次。已收码不按未收码规则退款。请查询订单里的取消和退款状态，申请已提交不等于退款已完成。
已有接入的兼容说明
现有 /api/reseller 长期号接入及分销商账户继续可用。新接入使用 /api/v1；临时号、钱包流水及普通续费需要普通账户，旧分销商充值继续使用原门户。
通过 Vozira SMS 接入
在 Vozira 账户的 API Access 中生成密钥，按需要的号码类型接入。完整文档包含请求字段、状态处理、错误响应，以及 Python 和 Node.js 示例。