文档中心

**简要描述：** 获取按时业务详细信息。 **参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |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 |应付价格| | **备注：** 更多返回错误代码请看首页的错误代码描述。

## 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 | 重拨时间间隔限制或资源还在分配中 |

##1 接口描述 接口地址： https://proxy.qg.net/monopolies 本接口是用于释放申请到的独占IP，以便于再次进行独占IP申请。 请求限制：独占资源在申请后12小时才可释放，如果资源故障，可提交工单我们会强制释放； 方法：DELETE； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :----- | :------- | :----- | :----------------------------: | | Key | 是 | String | 释放独占资源的Key值； | | UUIDs | 是 | String | 独占资源编号，多个用","隔开。 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :--------------------------: | | data | Array | 释放成功的独占资源编号数组； | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl -X DELETE "https://proxy.qg.net/monopolies?Key=请改成您的Key&UUIDs=XX,XXXX" ``` 返回示例： ``` { "data": ["fj_xmdx2-1:ppp10"] //删除成功的资源 } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------------------------------: | | 200 | 删除成功 | | 400 | 释放时间限制，申请后12小时可释放 |

## 1说明 通过编码使用静态独享代理主要有以下三步骤： （1）先在[会员中心](https://www.qg.net/user/ "会员中心")上查看购买的静态独享代理，进行本地调试和验证；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤＞＞") （2）参考[代码样例](https://www.qg.net/list/192.html)请求静态独享代理； （3）在程序中通过调用API接口获取代理，然后请求目标网站。 ## 2 API接口 静态独享代理API接口一览 | 接口类型 | API | 描述 | | ------------ | ------------------------------------------------------------ | ------------------------------------------------------------ | | 资源相关 | - [allocate](https://www.qg.net/doc/174.html "资源申请")
- [query](https://www.qg.net/doc/1504.html "获取IP资源池")
- [release](https://www.qg.net/doc/176.html "释放资源")
| - 调用 allocate申请代理IP资源
- 调用query查询IP资源池全部可用的IP信息
- 调用release释放申请到的IP，以便于再次进行IP申请。 | | 白名单相关 | - [whitelist/query](https://www.qg.net/doc/180.html "whitelist/query")
- [whitelist/add](https://www.qg.net/doc/178.html "whitelist/add")
- [whitelist/del](https://www.qg.net/doc/179.html "删除白名单")
| - 调用 whitelist/query用于查询IP的白名单
- 调用whitelist/add用于添加IP的白名单
- 调用whitelist/del用于删除IP的白名单 | | 资源信息查询 | - [info/quota](https://www.qg.net/doc/181.html "info/quota")
- [resources](https://www.qg.net/doc/177.html "查询区域资源") | - 调用 info/quota查询IP提取余量
- 调用extract查询平台可用的代理IP资源列表 |