Rental API
SMSPVA / DOCUMENTATION
恢复租赁
GET /api/rent.php?method=restore_user
SMSPVA API
发送 GET 请求后,检查 JSON 中的 status:1 成功,0 失败,即使 HTTP 为 200 也一样。失败原因见 msg。
此请求可能修改租赁订单或产生费用。响应丢失后,先查询订单及历史,再决定是否重试:更改可能已经生效。示例不会自动重试。
身份验证
apikey 为必填查询参数。
参数
| 名称 | 位置 | 类型 | 必填 | 示例 | 说明 |
|---|---|---|---|---|---|
method | query | string | 是 | "restore_user" | 方法名称 |
apikey | query | string | 是 | SMSPVA_API_KEY | 你的 API 密钥 可在网站右上角菜单的 Profile and APIKEY 中找到。 |
id | query | integer | 是 | "" | 订单 ID |
使用说明
恢复符合条件的已结束租赁。先在历史获取 ID,检查 isAvailForRestore,并确认费用与时长。
成功时 status=1,data.id 为恢复后的新订单 ID。用它查询租赁订单。若 status=0,原因见 msg。
请求示例
运行环境及依赖. 示例会对查询参数编码,最多等待 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" \
--data-urlencode "apikey=$SMSPVA_API_KEY" \
--data-urlencode "id=$SMSPVA_RENTAL_ORDER_ID"响应
请查看与你的请求对应的响应。数值和日期仅供示例;可选字段可能因结果或所选响应格式而不同。
HTTP 200
成功时返回恢复后的订单 ID,失败时返回错误信息。
application/json
恢复成功
{
"status": 1,
"data": {
"id": 123456
}
}Incorrect order ID
{
"status": 0,
"msg": "Incorrect order id"
}Order not found
{
"status": 0,
"msg": "Order not found"
}Not enough balance
{
"status": 0,
"msg": "NOBALANCE_12.50"
}Number is busy
{
"status": 0,
"msg": "The number is busy, there is already an order for this service"
}成功
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 请求状态。1 表示订单恢复成功。 |
data | object | 恢复后的订单数据。 |
data.id | integer | 恢复后的新订单 ID。 |
必填: status, data
错误
| 名称 | 类型 | 说明 |
|---|---|---|
status | integer | 请求状态。0 表示恢复失败。 |
msg | string | 错误信息。 |
必填: status, msg