第一步，进入调试工具后，选择接口方法为【通道配额】； 第二步，在Key的输入框输入已购买的代理IP业务AuthKey值； 第三步，点击测试按钮即可进行查询。 如下图所示：  参数说明： Total：总计可用通道数量（按时或按时按量）或总计购买IP数量（按量模式）； Available：当前可用通道或IP数量； Used：当前已经使用的通道或IP数量。
| 代码 | 解释说明 | 解决建议 | | :-----------------------------: | :----------------------------------------------------------- | :----------------------------------------------------------- | | success | 请求成功。 | | | bad request | 错误的请求。客户端发出了无法被正确识别的请求，或者请求存在网络问题。 | 请使用标准的HTTP(S)/SOCKS协议，或检查一下客户端网络情况。 | | client ip unavailable | 客户端IP未获得许可。国内代理产品不支持在中国大陆地区以外的环境使用，全球http产品不支持在中国大陆地区网络环境下使用。 | 客户端IP需符合产品的使用要求。 | | conn num exceed | 单个IP保持的TCP连接超出限制。IP的TCP连接数存在上限。如果请求之后没有主动关闭连接，TCP连接将会保持。 | 请主动关闭已经不再使用的TCP连接。 | | request exceed | 每秒请求数超出。只会出现于隧道动态请求 | 请在客户端做并发限制，按照购买的QPS来发起请求。 | |get out conn timeout/connect target timeout| 请求连接超时。当前代理IP访问目标网站的请求返回超时。 | 请检查该目标网站在正常网络环境下，是否可以正常访问。 | | loop detected | 连接死循环。错误使用代理IP而导致的死循环，如：使用代理IP访问当前这个代理IP本身。 | 请检查程序是否存在错误。 | | proxy auth failed | 代理授权失败。一般是账密错误，或者没有正确配置白名单。 | 请检查账密、白名单是否正常配置。此外客户端有多出口IP也可能会导致此问题。 | | request header fields too large | 请求Header过长。客户端的请求Header长度不允许超过8190字节。 | 请调整请求Header长度后再做尝试。 | | request method no acceptable | 请求方法不被允许。使用了不标准的Socks5协议。 | 请使用标准的Socks5协议。 | | target website is forbiden | 目标站不允许访问。访问的目标网站由于政策原因并不允许访问。 | 代理IP的使用需要符合政策要求。 | | service unavailable | 服务不可用。 | 建议重新发起访问请求或更换新的IP。 | | internal server err | 服务端网络错误。因代理IP资源不足或质量不稳定引起的网络问题。 | 建议重新发起访问请求或更换新的IP。 | | user expired | Key过期。 | 建议及时续费。 |
## 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 | 重拨时间间隔限制或资源还在分配中 |
|国家编码|国家中文|国家英文|青果编码| |:---- |:---|:----- |:----- | |AD|安道尔|Andorra|993000| |AE|阿拉伯联合酋长国|United Arab Emirates|993400| |AF|阿富汗|Afghanistan|994000| |AG|安提瓜和巴布达|Antigua and Barbuda|994100| |AI|安圭拉|Anguilla|994200| |AL|阿尔巴尼亚|Albania|994300| |AM|亚美尼亚|Armenia|994400| |AO|安哥拉|Angola|994500| |AR|阿根廷|Argentina|994600| |AS|美属萨摩亚|American Samoa|994700| |AT|奥地利|Austria|994800| |AU|澳大利亚|Australia|991000| |AW|阿鲁巴|Aruba|994900| |AZ|阿塞拜疆|Azerbaijan|995000| |BA|波斯尼亚和黑塞哥维那|Bosnia and Herzegovina|995100| |BB|巴巴多斯|Barbados|995200| |BD|孟加拉国|Bangladesh|995300| |BE|比利时|Belgium|992000| |BF|布基纳法索|Burkina Faso|995400| |BG|保加利亚|Bulgaria|995500| |BH|巴林|Bahrain|992900| |BI|布隆迪|Burundi|995600| |BJ|贝宁|Benin|995700| |BL|巴勒斯坦|Palestine|995800| |BM|百慕大群岛|Bermuda|995900| |BN|文莱|Brunei|996000| |BO|玻利维亚|Bolivia|996100| |BR|巴西|Brazil|992400| |BS|巴哈马|Bahamas|996200| |BT|不丹|Bhutan|996300| |BW|博茨瓦纳|Botswana|996400| |BY|白俄罗斯|Belarus|996500| |BZ|伯利兹|Belize|996600| |CA|加拿大|Canada|992300| |CD|刚果民主共和国|Democratic Republic of the Congo|996700| |CF|中非共和国|Central African Republic|996800| |CG|刚果共和国|Republic Of The Congo|996900| |CH|瑞士|Switzerland|991200| |CI|象牙海岸|Ivory Coast|997000| |CK|库克群岛|Cook Islands|997100| |CL|智利|Chile|993700| |CM|喀麦隆|Cameroon|997200| |CO|哥伦比亚|Colombia|997300| |CR|哥斯达黎加|Costa Rica|997400| |CU|古巴|Cuba|997500| |CV|开普|Cape Verde|997600| |CW|库拉索|Curacao|997700| |CY|塞浦路斯|Cyprus|997800| |CZ|捷克|Czech|997900| |DE|德国|Germany|991900| |DJ|吉布提|Djibouti|998000| |DK|丹麦|Denmark|998100| |DM|多米尼加|Dominica|998200| |DO|多米尼加共和国|Dominican Republic|998300| |DZ|阿尔及利亚|Algeria|998400| |EC|厄瓜多尔|Ecuador|998500| |EE|爱沙尼亚|Estonia|998600| |EG|埃及|Egypt|998700| |ER|厄立特里亚|Eritrea|998800| |ES|西班牙|Spain|993500| |ET|埃塞俄比亚|Ethiopia|998900| |FI|芬兰|Finland|991700| |FJ|斐济|Fiji|999000| |FO|法罗群岛|Faroe Islands|999100| |FR|法国|France|991800| |GA|加蓬|Gabon|999200| |GB|英国|United Kingdom|991100| |GD|格林纳达|Grenada|999300| |GE|格鲁吉亚|Georgia|999400| |GF|法属圭亚那|French Guiana|999500| |GH|加纳|Ghana|999600| |GI|直布罗陀|Gibraltar|999700| |GL|格陵兰岛|Greenland|999800| |GM|冈比亚|Gambia|999900| |GN|几内亚|Guinea|980100| |GP|瓜德罗普岛|Guadeloupe|980200| |GQ|赤道几内亚|Equatorial Guinea|980300| |GR|希腊|Greece|980400| |GT|瓜地马拉|Guatemala|980500| |GU|关岛|Guam|980600| |GW|几内亚比绍共和国|Guinea-Bissau|980700| |GY|圭亚那|Guyana|980800| |HK|中国香港|Hong Kong|990201| |HN|洪都拉斯|Honduras|980900| |HR|克罗地亚|Croatia|981000| |HT|海地|Haiti|981100| |HU|匈牙利|Hungary|981200| |ID|印度尼西亚|Indonesia|990600| |IE|爱尔兰|Ireland|992100| |IL|以色列|Israel|993600| |IN|印度|India|992200| |IQ|伊拉克|Iraq|981300| |IR|伊朗|Iran|981400| |IS|冰岛|Iceland|981500| |IT|意大利|Italy|991500| |JM|牙买加|Jamaica|981600| |JO|约旦|Jordan|981700| |JP|日本|Japan|990400| |KE|肯尼亚|Kenya|981800| |KG|吉尔吉斯斯坦|Kyrgyzstan|981900| |KH|柬埔寨|Cambodia|982000| |KI|基里巴斯|Kiribati|982100| |KM|科摩罗|Comoros|982200| |KN|圣基茨和尼维斯|Saint Kitts and Nevis|982300| |KR|韩国|South Korea|990800| |KW|科威特|Kuwait|982400| |KY|开曼群岛|Cayman Islands|982500| |KZ|哈萨克斯坦|Kazakhstan|982600| |LA|老挝|Laos|982700| |LB|黎巴嫩|Lebanon|982800| |LC|圣露西亚|Saint Lucia|982900| |LI|列支敦士登|Liechtenstein|983000| |LK|斯里兰卡|Sri Lanka|983100| |LR|利比里亚|Liberia|983200| |LS|莱索托|Lesotho|983300| |LT|立陶宛|Lithuania|983400| |LU|卢森堡|Luxembourg|983500| |LV|拉脱维亚|Latvia|983600| |LY|利比亚|Libya|983700| |MA|摩洛哥|Morocco|983800| |MC|摩纳哥|Monaco|983900| |MD|摩尔多瓦|Moldova|984000| |ME|黑山|Montenegro|984100| |MG|马达加斯加|Madagascar|984200| |MK|马其顿|Macedonia|984300| |ML|马里|Mali|984400| |MM|缅甸|Myanmar|984500| |MN|蒙古|Mongolia|984600| |MO|中国澳门|Macau|990202| |MQ|马提尼克|Martinique|984700| |MR|毛里塔尼亚|Mauritania|984800| |MS|蒙特塞拉特岛|Montserrat|984900| |MT|马耳他|Malta|985000| |MU|毛里求斯|Mauritius|985100| |MV|马尔代夫|Maldives|985200| |MW|马拉维|Malawi|985300| |MX|墨西哥|Mexico|992700| |MY|马来西亚|Malaysia|990700| |MZ|莫桑比克|Mozambique|985400| |NA|纳米比亚|Namibia|985500| |NC|新喀里多尼亚|New Caledonia|985600| |NE|尼日尔|Niger|985700| |NG|尼日利亚|Nigeria|992800| |NI|尼加拉瓜|Nicaragua|985800| |NL|荷兰|Netherlands|991600| |NO|挪威|Norway|991400| |NP|尼泊尔|Nepal|985900| |NZ|新西兰|New Zealand|986000| |OM|阿曼|Oman|986100| |PA|巴拿马|Panama|986200| |PE|秘鲁|Peru|986300| |PF|法属波利尼西亚|French Polynesia|986400| |PG|巴布亚新几内亚|Papua New Guinea|986500| |PH|菲律宾|Philippines|990900| |PK|巴基斯坦|Pakistan|986600| |PL|波兰|Poland|993300| |PM|圣彼埃尔和密克隆岛|Saint Pierre and Miquelon|986700| |PR|波多黎各|Puerto Rico|986800| |PT|葡萄牙|Portugal|986900| |PW|帕劳|Palau|987000| |PY|巴拉圭|Paraguay|987100| |QA|卡塔尔|Qatar|993900| |RE|留尼汪|Réunion Island|987200| |RO|罗马尼亚|Romania|987300| |RS|塞尔维亚|Serbia|987400| |RU|俄罗斯|Russia|992600| |RW|卢旺达|Rwanda|987500| |SA|沙特阿拉伯|Saudi Arabia|993100| |SB|所罗门群岛|Solomon Islands|987600| |SC|塞舌尔|Seychelles|987700| |SD|苏丹|Sudan|987800| |SE|瑞典|Sweden|991300| |SG|新加坡|Singapore|990300| |SI|斯洛文尼亚|Slovenia|987900| |SK|斯洛伐克|Slovakia|988000| |SL|塞拉利昂|Sierra Leone|988100| |SM|圣马力诺|San Marino|988200| |SN|塞内加尔|Senegal|988300| |SO|索马里|Somalia|988400| |SR|苏里南|Suriname|988500| |ST|圣多美和普林西比|Sao Tome and Principe|988600| |SV|萨尔瓦多|El Salvador|988700| |SX|圣马丁岛（荷兰部分）|Saint Maarten (Dutch Part)|988800| |SY|叙利亚|Syria|988900| |SZ|斯威士兰|Swaziland|989000| |TC|特克斯和凯科斯群岛|Turks and Caicos Islands|989100| |TD|乍得|Chad|989200| |TG|多哥|Togo|989300| |TH|泰国|Thailand|990500| |TJ|塔吉克斯坦|Tajikistan|989400| |TL|东帝汶|Timor-Leste|989500| |TM|土库曼斯坦|Turkmenistan|989600| |TN|突尼斯|Tunisia|989700| |TO|汤加|Tonga|989800| |TR|土耳其|Turkey|993800| |TT|特立尼达和多巴哥|Trinidad and Tobago|989900| |TW|中国台湾|Taiwan|990203| |TZ|坦桑尼亚|Tanzania|970100| |UA|乌克兰|Ukraine|970200| |UG|乌干达|Uganda|970300| |US|美国|United States|990100| |UY|乌拉圭|Uruguay|970400| |UZ|乌兹别克斯坦|Uzbekistan|970500| |VC|圣文森特和格林纳丁斯|Saint Vincent and The Grenadines|970600| |VE|委内瑞拉|Venezuela|970700| |VG|英属处女群岛|Virgin Islands, British|970800| |VI|美属维尔京群岛|Virgin Islands, US|970900| |VN|越南|Vietnam|993200| |VU|瓦努阿图|Vanuatu|971000| |WS|萨摩亚|Samoa|971100| |YE|也门|Yemen|971200| |YT|马约特|Mayotte|971300| |ZA|南非|South Africa|992500| |ZM|赞比亚|Zambia|971400| |ZW|津巴布韦|Zimbabwe|971500|
**简要描述：** 获取按量业务详细信息。 **参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |resource_no |是 |string |按量业务标识 | **输入示例：** - https://qg.net/api/proxyip/resourceView?resource_no=xxx **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "Authkey": "3BZEOGS0", "Number": 10000, "Buy_time": "2021-03-25 16:15:21", "End_time": "2023-03-25 16:15:21", "Order_status": 1, "Type": 2, "Ip_type": 2, "Resource_available": 10000, "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：过期,-1：已失效,-4：开通失败;-5：续费失败, -6：升级失败, -7：锁定| |Type |integer |资源类型 1：独享，2：共享；3：独占| |Ip_type |integer |IP类型 1：静态，2：动态，3：隧道| |Resource_available |integer |按量业务余量| |Tunnel_url |string |隧道地址| **备注：** 更多返回错误代码请看首页的错误代码描述。
**简要描述：**
- 业务续费
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|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 |业务到期时间 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
##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小时可释放 |
**简要描述：**
- 业务购买
**输入参数：**
|参数名|必选|类型|说明|
|:---- |:---|:----- |----- |
|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 |隧道地址 |
**备注：**
更多返回错误代码请看首页的错误代码描述。
搜狗浏览器只支持http和https协议，不支持socks协议，那么搜狗浏览器如何使用代理IP呢？ 本文将针对此问题进行详细说明。 在【代理ip】-【按时业务/按量业务】里查看自己购买的代理ip，然后点击【查看详情】查看自己的AuthKey跟AuthPwd；   使用自己购买的AuthKey去【调试工具】里面选择【提取IP资源】获取ip；   获取到ip之后，先打开搜狗浏览器，然后点击右上角的菜单；  点击【代理服务器】，然后选择【代理服务器设置】；  在弹出【自定义代理】，点击【添加】；  然后输入【代理名称】，【代理地址】跟【端口】然后勾选【需要验证】，然后输入【用户名】和【密码】（用户名就是AuthKey，密码就是AuthPwd），然后勾选【添加后立即启用】再点击【确定】；  浏览器打开https://myipip.net， 查询IP，结果里出现的IP地址和设置的代理IP一致，说明代理设置成功；  取消代理的话，先点击右上角菜单，点击【代理设置】，然后选择【不使用任何代理】即可取消掉代理。
**简要描述：** - 获取按时产品列表信息。 **输入示例：** - https://qg.net/api/Proxyip/channelSpecList **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "1":{ "Id": 1, "Spec_name": "独享动态", "Spec_no": "14995", "Trial_time": 8, "Day_rate": "0.08", "Week_rate": "0.40", "Month_rate": "1,3,6,10,20,30", "Computing_time": "1,3,6,12,24,36", "Show_status": 1, "Buy_status": 1, "Renew_status": 1, "Upgrade_status": 1, "Content": "IP数量 : 同时可使用的IP数等于购买的通道数 IP存活时长 : 自由控制，最长24小时，IP存活时长大于30秒后，可以随时更换IP IP可用率 : ＞99.9%，IP检测可用后才会进入IP池 IP重复率 : <1%?优先分配未使用IP给客户 IP分布地区 : 全国主要省份?更多城市还在不断增加中 终端数限制 : 不限制?支持多机器或多进程同时使用代理IP 带宽峰值限制 : 10Mbps 地区筛选 : 支持指定获取某个城市IP或全国随机 代理类型 : HTTP、HTTPS、SOCKS5", "Basic_price": "59.00", "Group_type_id": 1, "Brand_name": "青果云", "Create_time": 1598204266, "Update_time": 1598204266, "Connect_limit": 132, "Connect_price": "10.00", "Connect_gift": 1, "Connect_list": "1-10", } }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Id |integer |ID | |Spec_name |string |产品名称 | |Trial_time |integer |试用时间 单位小时| |Day_rate |float |日付费率 | |Week_rate |float |周付费率 | |Month_rate |float |月付费率 | |Computing_time |string |可选时长 | |Show_status |integer |显示状态 1:显示 0：不显示 | |Buy_status |integer |购买状态 1:启用 0：禁用 | |Renew_status |integer |续费状态 1:启用 0：禁用 | |Upgrade_status |integer |升级状态 1:启用 0：禁用| |Content |string |基本介绍| |Basic_price |float |基础价格 | |Group_type_id |integer |规格ID| |Brand_name |string |品牌名称| |Connect_limit |string |IP类型为动态或者静态：连接数限制；IP类型为隧道固定时长：请求数限制| |Connect_price |string |连接数单价| |Connect_gift |string |连接数赠送值| |Connect_list |string |连接数可选值| **备注** - 更多返回错误代码请看首页的错误代码描述
