续费应用订单-帮助中心 - 小象代理 - 优质高速HTTP代理IP-爬虫-代理服务器

续费应用订单

更新时间： 2023-09-14 14:42:01

[TOC]

### 1. 接口描述

- 本接口用于续费应用创建订单，通过该接口可以创建续费订单对应用进行续费，订单自动使用钱包余额支付。
- 一次调用限创建一个续费订单，一个订单使用余额支付后续费一个应用，如需创建多个续费订单请分多次调用本接口。
- 调用本接口前请提前确保账户余额充足。
- 必须使用账户API密钥调用本接口。

### 2. 调用频率

- 1次/秒

### 3. 请求URL

- `https://api.xiaoxiangdaili.com/order/postpone`

### 4. 请求方式

- GET

### 5. 请求参数说明

####  5.1 公共参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|userKey| 是 | 用户API账号 | <a class="auth-link" href="https://www.xiaoxiangdaili.com/u/acc/api/setting">查看API账号与密钥信息</a> |
|userSecret| 是 | 用户API密钥 | - |
|appKey| 是 | 应用账号 | - |
|useCoupon| 否 | 是否使用优惠券，自动选择最大优惠的优惠券，没有可用优惠券时创建订单不受影响 | 0：不使用(默认) 1：使用 |
|useActivity| 否 | 是否参与活动，自动选择最大优惠的活动，没有可参与活动时创建订单不受影响 | 0：不使用(默认) 1：使用 |

####  5.2 短效代理(包量)相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|quantity| 是 | 购买的IP数量，查看官网对应套餐的数值 | IP数量(个) |

####  5.3 静态代理(包时)相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|ip| 是 | 服务器地址 | - |
|timeType| 是 | 时间单位 | H：小时 D：天 W：周 M：月 S：季 Y：年 |
|timeNum| 否 | 时间数量，最大值为100 | 默认值：1 |

####  5.4 其他代理(包时)相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|timeType| 是 | 时间单位 | H：小时 D：天 W：周 M：月 S：季 Y：年 |
|timeNum| 否 | 时间数量，最大值为100 | 默认值：1 |

### 6. 调用示例

####  6.1 续费短效代理包量套餐
 调用示例：续费20000个IP

```rust
GET https://api.xiaoxiangdaili.com/order/postpone?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appKey=955013713558392832
		&quantity=20000
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955040668265500672",
        "appKey": "955013713558392832",
        "ipBalance": "44000"
    },
    "msg": "操作成功"
}
```

返回参数说明

|参数名|参数说明|
|:-----|-----|
| orderNo | 订单号 |
| appKey | 应用账号 |
| ipBalance | IP剩余量 |

####  6.2 续费静态代理包时套餐
 调用示例：续费1季

```rust
GET https://api.xiaoxiangdaili.com/order/postpone?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appKey=940069145515806720
		&ip=127.0.0.2:81
		&timeType=S
		&timeNum=1
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955041349193977856",
        "secretKey": "940069145515806720",
        "ip": "127.0.0.2:81",
        "expireTime": "2023-09-20 17:53:21"
    },
    "msg": "操作成功"
}
```

返回参数说明

|参数名|参数说明|
|:-----|-----|
| orderNo | 订单号 |
| secretKey | 静态代理调用账号 |
| ip | 服务器地址 |
| expireTime | 过期时间 |

####  6.3 续费其他代理包时套餐
 调用示例：续费1月

```rust
GET https://api.xiaoxiangdaili.com/order/postpone?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appKey=955019144095748096
		&timeType=M
		&timeNum=1
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955053443226292224",
        "appKey": "955019144095748096",
        "expireTime": "2023-04-20 16:25:07"
    },
    "msg": "操作成功"
}
```

返回参数说明

|参数名|参数说明|
|:-----|-----|
| orderNo | 订单号 |
| appKey | 应用账号 |
| expireTime | 过期时间 |

### 7.错误码一览表
|错误码|说明|
|:-----|-----|
| 1001 | 应用不存在 |
| 1002 | 应用已被冻结或禁用 |
| 1003 | 应用已过期 |
| 3000 | 账户授权验证未通过 |
| 3003 | 余额不足 |
| 3008 | 未完成实名认证 |
| 3010 | 无可用套餐 |
| 3011 | 参数不足 |

上一篇：创建应用订单

下一篇：升级应用订单