SMSPVAdevelopers
Rental API
SMSPVA / DOCUMENTATION

租赁流程

创建、激活、读取短信、延期和恢复租赁。

SMSPVA API

1. 选择国家、服务及租期

从实时租赁列表及租赁国家开始。使用相同国家及租期查询供应商数据,比较服务、价格和余量。

多服务使用逗号分隔的 services,并查询多服务余量。按原文档建议,明确传入该方法的 dtype 和 dcount。多数租期接口使用 week/month,不要假定都支持天。

2. 创建一次租赁

调用创建租赁或多服务租赁,保存 data.id、pnumber、ccode、until。它们是租赁数据,不是 Activation V2 订单 ID。两者按文档使用 GET,可能创建付费订单。响应丢失后先检查订单,不要直接重复创建。

3. 发短信前先激活

调用激活租赁,再从订单检查 state:0 未激活、1 已激活、2 正在激活、-1 不在系统中。确认已激活后再发送短信。激活请求 status=1 不代替订单状态检查。

4. 读取消息

租赁短信在 status=1 后读取 data.SmsList 和 data.OtherSms。空列表表示该列表当前无消息,不是 Activation V2 的 HTTP 202 等待响应。

重复读取可能返回已处理的短信,应在应用中维护处理状态。轮询应间隔执行,并在完成任务或租赁过期时停止;不要自行定义统一数值限流。接口示例仅请求一次,不自动重试。

5. 修改与延期

  • 添加服务:需要 id、pnumber 和 service;rent_days 可选。
  • 延长租赁:使用 week/month,先检查 canprolong、canprolongmax、canprolonguntil。
  • 按天延长:dtype=day、dcount=1–6,且不能超出 canprolongmax。
  • 移除订单:使用 GET 加 method=delete,不是 HTTP DELETE。

示例不会自动执行这些管理操作。

6. 恢复已完成租赁

查看历史及 isAvailForRestore。先调用恢复预估,检查价格、时长后再恢复租赁。成功的 data.id 是新的恢复订单 ID。HTTP 200 下的 status=0 与 msg 仍表示失败。

时间字段

创建响应的 until 定义为字符串,订单列表定义为整数,分别保留原类型。时间戳单位为 Unix 秒;不要套用 Activation V2 的 orderExpireIn。

本页内容