Rental API
SMSPVA / DOCUMENTATION
恢复预估
GET /api/rent.php?method=restore_user_precalc
SMSPVA API
发送 GET 请求后，检查 JSON 中的 status：1 成功，0 失败，即使 HTTP 为 200 也一样。失败原因见 msg。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "restore_user_precalc" | 方法名称 |
apikey | query | string | 是 | SMSPVA_API_KEY | 你的 API 密钥 可在网站右上角菜单的 Profile and APIKEY 中找到。 |
id | query | integer | 是 | "" | 订单 ID |
使用说明
查询过期租赁的恢复费用、时长及可用情况。订单 ID 取自租赁历史，且 isAvailForRestore 必须为 true。这一步仅作预估，实际恢复需调用恢复租赁。
请求示例
运行环境及依赖. 示例会对查询参数编码，最多等待 30 秒。使用 data 前请检查 HTTP 和 JSON status。cURL 输出原始响应供你检查，Java 使用 Jackson 读取 JSON。
SMSPVA_RENTAL_ORDER_ID: id.
: "${SMSPVA_API_KEY:?Set SMSPVA_API_KEY}"
: "${SMSPVA_RENTAL_ORDER_ID:?Set SMSPVA_RENTAL_ORDER_ID}"
curl --get --fail-with-body --max-time 30 "https://smspva.com/api/rent.php" \
--data-urlencode "method=restore_user_precalc" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "id=$SMSPVA_RENTAL_ORDER_ID"响应
请查看与你的请求对应的响应。数值和日期仅供示例；可选字段可能因结果或所选响应格式而不同。
HTTP 200
Success
application/json
响应示例
{
"status": 1,
"data": {
"ccode": "LT",
"scode": "opt9",
"price": 1.5,
"sname": "Instagram",
"pnumber": "37067787324",
"outdays": 5,
"orderid": 857191,
"prolongTo": 30
}
}| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态：1 成功，0 失败。 |
data | object | |
data.ccode | string | 号码所属国家代码。 国家列表 |
data.scode | string | 服务代码 服务列表 |
data.price | number | 恢复该订单的费用 |
data.sname | string | 服务名称 |
data.pnumber | string | 租赁号码，含国家区号，不带 +。 |
data.outdays | integer | 订单过期至今的天数 |
data.orderid | integer | 订单 ID |
data.prolongTo | integer | 恢复后订单的有效天数 |
msg | string | status 为 0 时的错误原因。 |