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

创建应用订单

更新时间： 2023-09-14 14:41:36

[TOC]

### 1. 接口描述

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

### 2. 调用频率

- 1次/秒

### 3. 请求URL

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

### 4. 请求方式

- GET

### 5. 请求参数说明

####  5.1 公共参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|userKey| 是 | 用户API账号 | <a class="auth-link" href="https://www.xiaoxiangdaili.com/u/acc/api/setting">查看API账号与密钥信息</a> |
|userSecret| 是 | 用户API密钥 | - |
|appType| 是 | 产品类型 | 1：短效代理 2：长效代理 3：隧道代理（短效版） ~~4：隧道代理（长效版）~~ 5：隧道代理（动态转发） 6：IP池客户端 7：静态代理IP |
|settleType| 是 | 套餐类型 | 1：包时 2：包量 |
|useCoupon| 否 | 是否使用优惠券，自动选择最大优惠的优惠券，没有可用优惠券时创建订单不受影响 | 0：不使用(默认) 1：使用 |
|useActivity| 否 | 是否参与活动，自动选择最大优惠的活动，没有可参与活动时创建订单不受影响 | 0：不使用(默认) 1：使用 |

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

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|pricingType| 否 | 计费类型 | 1：单次提取限量(默认值) 2：单日提取限量 |
|timeType| 是 | 时间单位 | H：小时 D：天 W：周 M：月 S：季 Y：年 |
|timeNum| 否 | 时间数量，最大值为100 | 默认值：1 |
|proxyDuration| 是 | IP有效时长 | 2 : 1-2分钟 5 : 2-5分钟 10 : 5-10分钟 |
|limit| 是 | pricingType=1：单提限量 pricingType=2：单日限量 | 单提限量取值范围为：1-200 单日限量取值范围为：1000-100000（1000的倍数）|

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

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|quantity| 是 | 购买的IP数量，查看官网对应套餐的数值 | IP数量(个) |
|proxyDuration| 是 | IP有效时长 | 2 : 1-2分钟 5 : 2-5分钟 10 : 5-10分钟 |

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

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

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

####  5.6 IP池代理相关参数

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|timeType| 是 | 时间单位 | H：小时 D：天 W：周 M：月 S：季 Y：年 |
|timeNum| 否 | 时间数量，最大值为100 | 默认值：1 |
|proxyDuration| 是 | IP有效时长 | 2 : 1-2分钟 5 : 2-5分钟 10 : 5-10分钟 |
|limit| 是 | 通道数量 | 取值范围为：5-200 |

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

|参数名|必选|参数说明|取值说明|
|:-----|:-----|:-----|-----|
|timeType| 是 | 时间单位 | H：小时 D：天 W：周 M：月 S：季 Y：年 |
|timeNum| 否 | 时间数量，最大值为100 | 默认值：1 |
|proxyDuration| 是 | IP有效时长 | 2 : 1-2分钟 5 : 2-5分钟 10 : 5-10分钟 |
|limit| 是 | 每秒请求数 | 取值范围为：5-100 |

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

### 6. 调用示例

####  6.1 购买短效代理包时套餐
 调用示例：按单次提取计费、购买2天、IP有效时长1-2分钟、单提限量为2

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=1
		&settleType=1
		&pricingType=1
		&timeType=D
		&timeNum=2
		&proxyDuration=2
		&limit=2
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955009363121295360",
        "appKey": "955009363708628992",
        "expireTime": "2022-06-22 15:46:15"
    },
    "msg": "操作成功"
}
```

返回参数说明

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

####  6.2 购买短效代理包量套餐
 调用示例：购买20000个IP、IP有效时长1-2分钟

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=1
		&settleType=2
		&proxyDuration=2
		&quantity=20000
```

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

返回参数说明

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

####  6.3 购买长效代理包时套餐
 调用示例：购买1月、IP数量为10

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=2
		&settleType=1
		&timeType=M
		&timeNum=1
		&limit=10
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955017890585923584",
        "appKey": "955017891101954048",
        "expireTime": "2022-04-20 16:20:08"
    },
    "msg": "操作成功"
}
```

返回参数说明

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

####  6.4 购买静态代理包时套餐
 调用示例：购买1季、带宽为2Mb/s

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=7
		&settleType=1
		&timeType=S
		&timeNum=1
		&limit=2
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955018139450757120",
        "secretKey": "940069145515806720",
        "ip": "127.0.0.2:81",
        "expireTime": "2023-06-20 16:21:07"
    },
    "msg": "操作成功"
}
```

返回参数说明

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

####  6.5 购买IP池代理包时套餐
 调用示例：购买2月、IP有效时长1-2分钟、通道数量为10

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=6
		&settleType=1
		&proxyDuration=2
		&timeType=M
		&timeNum=2
		&limit=10
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955018566686756864",
        "appKey": "955018566988877824",
        "expireTime": "2022-04-20 16:22:49"
    },
    "msg": "操作成功"
}
```

返回参数说明

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

####  6.6 购买隧道代理(短效版)套餐
 调用示例：购买1年、IP有效时长1-2分钟、每秒请求数为10

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=3
		&settleType=1
		&proxyDuration=2
		&timeType=Y
		&timeNum=1
		&limit=10
```

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

返回参数说明

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

####  6.7 购买隧道代理(动态转发)套餐
 调用示例：购买1月、每秒请求数为10

```rust
GET https://api.xiaoxiangdaili.com/order/create?
		userKey=950649340031422464
		&userSecret=q4adDKPC6KAc4AhPeT3F4GUvUNypXhAX
		&appType=5
		&settleType=1
		&timeType=M
		&timeNum=1
		&limit=10
```

```json
{
    "code": 200,
    "success": true,
    "data": {
        "orderNo": "955019525114580992",
        "appKey": "955019526041653248",
        "expireTime": "2022-06-20 16:26:38"
    },
    "msg": "操作成功"
}
```

返回参数说明

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

### 7.错误码一览表
|错误码|说明|
|:-----|-----|
| 3000 | 账户授权验证未通过 |
| 3003 | 余额不足 |
| 3008 | 未完成实名认证 |
| 3010 | 无可用套餐 |
| 3011 | 参数不足 |

下一篇：续费应用订单