Rental API
SMSPVA / DOCUMENTATION
租赁订单
GET /api/rent.php?method=orders
SMSPVA API
发送 GET 请求后,检查 JSON 中的 status:1 成功,0 失败,即使 HTTP 为 200 也一样。失败原因见 msg。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "orders" | 方法名称 |
apikey | query | string | 是 | SMSPVA_API_KEY | 你的 API 密钥 可在网站右上角菜单的 Profile and APIKEY 中找到。 |
使用说明
查看有效租赁、当前状态及延期选项。用订单 ID 激活、读取短信或延期。已结束的租赁及恢复资格见租赁历史。
请求示例
运行环境及依赖. 示例会对查询参数编码,最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查,Java 使用 Jackson 读取 JSON。
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=orders" \
--data-urlencode "apikey=$SMSPVA_API_KEY"响应
请查看与你的请求对应的响应。数值和日期仅供示例;可选字段可能因结果或所选响应格式而不同。
HTTP 200
Success
application/json
响应示例
{
"status": 1,
"data": [
{
"id": 40300,
"scode": "opt16",
"sname": "Instagram",
"state": 0,
"pnumber": "9096068511",
"ccode": "+7",
"cname": "KZ",
"hasnewsms": false,
"until": 1587552240,
"canprolong": true,
"canprolongmax": 162,
"canprolonguntil": 1634883780,
"lastonline": 1586947920
}
]
}| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态:1 成功,0 失败。 |
data | array<object> | |
data[].id | integer | 订单 ID |
data[].scode | string | 服务代码 服务列表 |
data[].sname | string | 服务名称 |
data[].state | integer | 订单状态:0 未激活,1 已激活,2 激活中,-1 系统中不存在。 |
data[].pnumber | string | 不含国家区号的电话号码 |
data[].ccode | string | 数字国家代码 |
data[].cname | string | 号码所属国家代码。 国家列表 |
data[].hasnewsms | boolean | 此订单收到新短信。 |
data[].until | integer | 到期时间(Unix 时间戳) |
data[].canprolong | boolean | 该订单是否可延期。 |
data[].canprolongmax | integer | 最多可延期的天数,不可超过此限制。 |
data[].canprolonguntil | integer | 可办理延期的截止时间,Unix 时间戳,超过后无法延期。 |
data[].lastonline | integer | 号码最近在线时间(Unix 时间戳) |