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

升级应用订单

更新时间： 2023-09-14 14:40:26

[TOC]

### 1. 接口描述

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

### 2. 调用频率

- 1次/秒

### 3. 请求URL

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

### 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 短效代理相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|limit| 是 | 单提限量/单日限量 | 大于原应用该参数值 单提限量取值范围为：1-200 单日限量取值范围为：1000-100000（1000的倍数）|

####  5.3 长效代理相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|limit| 是 | IP数量 | 大于原应用该参数值 取值范围为：1-50|

####  5.4 静态代理相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|ip| 是 | 服务器地址 | - |
|limit| 是 | 服务器带宽 | 大于原服务器该参数值 取值范围为：1-4|

####  5.5 IP池客户端相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|limit| 是 | 通道数量 | 大于原应用该参数值 取值范围为：5-200|

####  5.6 隧道代理(短效版)相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|limit| 是 | 每秒请求数 | 大于原应用该参数值 取值范围为：5-100|

####  5.7 隧道代理(动态转发)相关参数

### 6. 调用示例

####  6.1 升级静态代理包时套餐
 调用示例：静态代理升级带宽

```rust
GET https://api.xiaoxiangdaili.com/order/upgrade?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appKey=940069145515806720
		&ip=127.0.0.2:81
		&limit=3
```

```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.2 升级其他代理包时套餐
 调用示例：升级隧道代理(短效版)每秒请求数

```rust
GET https://api.xiaoxiangdaili.com/order/upgrade?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appKey=955019144095748096
		&limit=15
```

```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 | 参数不足 |

上一篇：续费应用订单