查询按时业务详情
**简要描述：**
获取按时业务详细信息。
**参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识 |
**输入示例：**
- https://qg.net/api/proxyip/view?suid=ebt2c7qr
**返回示例**
JSON格式
```
{
"RequestId":"ASDF4ASF-ASDFASF",
"Code": 200,
"Data": {
"Authkey": "2BE0556E",
"Number": 3,
"Buy_time": "2021-03-25 14:46:50",
"End_time": "2022-03-28 14:46:50",
"Order_status": 1,
"Type": 1,
"Ip_type": 2,
"Tunnel_url": "tunnel.qg.net:3434"
}，
"Message":"获取成功"
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|Authkey |string |Authkey |
|Number |integer |通道数|
|Connect |integer |连接数|
|Buy_time |string |购买时间|
|End_time |string |到期时间|
|Order_status |string |状态 1：正常, 3：过期,-4：开通失败; -5：续费失败, -6：升级失败, -7：锁定|
|Type |integer |资源类型 1：独享,2：共享；3：独占|
|Ip_type |integer |IP类型 1：静态,2：动态，3：隧道|
|Tunnel_url |string |隧道地址|
**备注：**
更多返回错误代码请看首页的错误代码描述。
按时业务升级
**简要描述：**
- 业务升级
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识 |
|number |否 |integer | 升级后通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 |
|connect |否 |integer | 升级后连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 |
**输入示例：**
- https://qg.net/api/product/upgradeOrderPay?suid=xxx&number=xxx&公共部分
**返回示例**
JSON格式
```
{
"RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3',
"Code": 200,
"Message": "订单支付成功!",
"Data": {
"Number": 3
},
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|Number |integer | 升级后通道数 |
|Connect |integer | 升级后连接数 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
按时业务升级询价
**简要描述：**
- 业务升级询价
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识 |
|number |否 |integer | 升级后通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 |
|connect |否 |integer | 升级后连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 |
**输入示例：**
- https://qg.net/api/Proxyip/getUpgradePrice?suid=xxx&number=1
**返回示例**
JSON格式
```
{
"RequestId":"ASDF4ASF-ASDFASF",
"Code": 0,
"Data": {
"OriginalPrice": "160",
"TotalPrice": "120",
},
"Message":"获取成功"
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|OriginalPrice |float |原价 |
|TotalPrice |float |应付价格 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
按时业务续费
**简要描述：**
- 业务续费
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识|
|duration |是 |string |续费时长 单位：
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
**输入示例：**
- https://qg.net/api/Proxyip/renewOrderPay?suid=xxx&duration=1d
**返回示例**
JSON格式
```
{
"RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3',
"Code": 200,
"Message": "订单支付成功!",
"Data": {
"EndTime": "2022-03-29 14:35:54"
},
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|EndTime |date |业务到期时间 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
按时业务续费询价
**简要描述：**
- 业务续费询价
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|suid |是 |string |业务标识 |
|duration |是 |string | 续费时长 单位：
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
**输入示例：**
- https://qg.net/api/Proxyip/getRenewPrice?suid=xxx&duration=1m
**返回示例**
JSON格式
```
{
"RequestId":"ASDF4ASF-ASDFASF",
"Code": 0,
"Data": {
"TotalPrice": "1231",
"OriginalPrice": "12154545",
"EndTime": "2020-05-20 00:00:00",
},
"Message":"获取成功",
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|TotalPrice |float |应付价格 |
|OriginalPrice |float |原价 |
|EndTime |date |业务到期时间 |
**备注：**
更多返回错误代码请看首页的错误代码描述
按时业务购买
**简要描述：**
- 业务购买
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|spec_id |是 |integer |按时产品ID |
|number |否 |integer | 通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 |
|connect |否 |integer | 连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 |
|duration |是 |string | 购买时长 单位：
- s: 小时，免费使用时长 例：2s（2小时）
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
**输入示例：**
- https://qg.net/api/Proxyip/pay?spec_id=888&number=1&duration=1d
**返回示例**
JSON格式
```
{
"RequestId":'423369C7-AD6F-3GT6-NMJ7-E2RG5N6HG7D3',
"Code": 200,
"Message": "购买成功",
"Data": {
"AuthKey": "17710BD8",
"AuthPwd": "8560577FC33A",
"Suid": "hryp84er",
"Tunnel_url" : "tunnel.qg.net:3434"
},
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|AuthKey |string |AuthKey |
|AuthPwd |string |AuthPwd |
|Suid |string |业务标识 |
|Tunnel_url |string |隧道地址 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
按时业务购买询价
**简要描述：**
- 业务购买询价
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|spec_id |是 |integer |按时产品ID |
|duration |是 |string | 购买时长 单位：
- s: 小时，免费试用时长 例：2s（2小时）
- d: 天 例：1d（1天）
- w: 周 例：1w（1周）
- m: 月 例：1m（1个月）
|
|number |否 |integer | 通道数，IP类型为静态、动态和隧道固定时长时必传；IP类型为隧道每次请求换ip时不需要传 |
|connect |否 |integer | 连接数，IP类型为隧道每次请求换ip时必传；其他类型不需要传 |
**输入示例：**
- https://qg.net/api/Proxyip/getPrice?spec_id=888&duration=1m&number=1
**返回示例**
JSON格式
```
{
"RequestId":"ASDF4ASF-ASDFASF",
"Code": 200,
"Data": {
"OriginPrice"：134，
"TotalPrice":68
}，
"Message":"获取成功"
}
```
**返回参数说明**
|参数名|类型|说明|
|:----- |:-----|----- |
|RequestId |string |请求编号 |
|Code |integer |返回状态码 |
|Message |string |返回内容 |
|OriginPrice |float |原价 |
|TotalPrice |float |应付价格| |
**备注：**
更多返回错误代码请看首页的错误代码描述。
查询白名单IP
## 1 接口描述
接口地址： https://proxy.qg.net/whitelist/query ；
本接口用于查询IP的白名单。
该接口单个Key的请求频率限制为：60次/分钟；
方法：HTTP、GET，需要注意不能混合使用；
编码：参数和返回内容均采用utf-8编码。
## 2 输入参数说明
|参数名|是否必选|类型|描述|
|:---- |:---|:----- |----- |
|Key |是 |String |查询白名单的Key值
|TaskID |是 |Integer |任务编号ID
|detail |是 |Integer |详情0(关闭) 1(开启)
## 3 返回值
接口可返回文本格式、json格式、xml格式，字段说明如下：
|参数名|类型|描述|
|:---- |:----- |----- |
|Code |Integer |结果编码，0：成功；-1：失败
|Num |Integer |数量
|Data |Array |IP白名单列表
## 4 示例
请求接口示例：
```
curl "https://proxy.qg.net/whitelist/query?Key=请改成您的Key"
```
返回示例：
```
{
"Code": 0,
"Num": 2,
"Data": [
"192.168.1.1",
"192.168.1.2"
]
}
```
## 5 接口返回错误码
| 错误码 | 描述 |
| ------------ | ------------ |
| -1 | 未知错误 |
| -10 | 参数不合法 |
| -11 | 请求过于频繁 |
| -100 | 计划不存在或已过期 |
删除白名单IP
## 1 接口描述
本接口用于删除IP的白名单。接口请求地址https://proxy.qg.net/whitelist/del ；
**注：**该接口单个Key的请求频率限制为：20 次/分钟。
## 2 输入参数说明
以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。
|参数名|是否必选|类型|描述|
|:---- |:---|:----- |----- |
|Key |是 |String |删除白名单的Key值|
|IP |是 |String|白名单IP，多个以逗号", "分隔|
## 3 返回值
|参数名|类型|描述|
|:---- |:----- |----- |
|Code |Integer |结果编码|
|Data |Array|删除成功的白名单数组|
|Num |Integer |删除成功的白名单个数|
## 4 示例
请求参数：
```
curl "https://proxy.qg.net/whitelist/del?Key=请改成您的Key&IP=1.1.1.1,2.2.2.2"
```
返回参数，JSON格式，详情如下：
```
{
"Code": 0,
"Data": [
"1.1.1.1",
"2.2.2.2"
],
"Num": 2
}
```
## 5 接口返回错误码
|错误码|描述|
|:---- |:----- |
| -1 | 未知错误 |
| -10 | 参数不合法 |
| -11 | 请求过于频繁 |
| -100 | 计划不存在或已过期 |
重拨独占资源
## 1 接口描述
接口地址： https://proxy.qg.net/monopolies/ips ；
本接口是用于请求重拨独占资源；
请求频率限制：按时业务是（通道数*5＋10）次/分钟；
方法：PUT；
编码：参数和返回内容均采用utf-8编码。
## 2 输入参数说明
| 参数名 | 是否必选 | 类型 | 描述 |
| :----- | :------- | :----- | :----------------------------: |
| Key | 是 | String | 重拨独占资源的Key值； |
| UUIDs | 是 | String | 独占资源编号，多个用","隔开 |
## 3 返回值
接口可返回文本格式、json格式、xml格式，字段说明如下：
| 返回字段 | 类型 | 描述 |
| :------- | :----- | :--------------------------: |
| data | Array | 重拨成功的独占资源编号数组 |
| error | String | 错误信息 |
## 4 示例
请求接口示例：
```
curl -X PUT -d "Key=请改成您的Key&UUIDs=XXX,XXX" "https://proxy.qg.net/monopolies/ips"
```
返回示例：
```
{
"data": ["fj_qzdx1-2:ppp1"] //重拨成功的资源uuids
}
```
## 5 接口返回错误码
| 错误码 | 描述 |
| :----: | :------------------------------: |
| 200 | 重拨成功 |
| 400 | 重拨时间间隔限制或资源还在分配中 |
