Account / 账户
读取当前认证账户的基础 API 账户信息。
开发者 API · Personal Beta 与 reseller 工作流
使用 Vozira 构建虚拟号码与短信工作流
通过一套 REST API 查询账户余额、搜索实时目录、购买当前可用号码、查看订单和短信，并为符合条件的本地会话续期。当前目录与实际订单返回始终是权威信息。
一套 API，七项聚焦能力
API 使用与 Vozira Web 产品相同的账户余额和当前目录，适合服务端集成以及合法的测试或自动化工作流。
Balance
购买前读取当前 Vozira 钱包余额。
Apps
搜索当前服务、国家、号码类型、库存和价格选项。
Buy
使用明确的幂等键购买当前可用选项。
Orders
查看最近 API 订单及其返回的号码信息。
SMS
读取属于当前账户的号码短信。
Extend
为符合条件的本地会话续期；供应商返回的有效期仍然优先。
Quick Start
在“控制台 → API Access”生成 API Key。密钥只能由服务端代码通过 X-Api-Key 请求头发送。
curl -H "X-Api-Key: YOUR_KEY" \
https://vozirasms.com/api/reseller/balance不得把完整密钥放入浏览器 JavaScript、查询字符串、公开截图或公共代码仓库。
可靠重试 Buy
每个 Buy 请求都必须携带 Idempotency-Key。只有重试完全相同的请求体时才复用同一键；改变请求体会产生冲突。
Idempotency-Key: purchase-unique-0001请求字段、数量限制和重试行为以权威详细文档为准。
稳定错误与合理轮询
结构化错误
API 错误提供稳定的机器可读代码、消息和 request ID。请按详细文档处理 HTTP 400、401、403、404、409、429 和 500。
限流响应
收到 HTTP 429 时遵守 Retry-After，不要立即连续重放 Buy 或 SMS 请求。
SMS 轮询
轮询间隔不得少于 5 秒。连续空结果后退避到约 10–15 秒，不要增加频率。
有效期与 end_time
不要假设所有号码具有统一有效期。供应商管理的号码返回 end_time；符合条件的本地会话可能使用 session_end。集成应保存并展示实际订单返回的值。
当前数据是权威来源
服务可用性、库存、国家、号码类型和价格会变化。Buy 前读取当前 Apps 响应；完成订单的返回值是扣费金额和号码有效期的权威来源。
选择合适的 API 入口
普通登录用户可在“控制台 → API Access”获取密钥和 Quick Start；Reseller 账户使用独立门户。详细文档只维护一个权威版本。