| 代码 | 解释说明 | 解决建议 | | :-----------------------------: | :----------------------------------------------------------- | :----------------------------------------------------------- | | 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过期。 | 建议及时续费。 |
第一步，进入调试工具后，选择接口方法为【查询IP资源】； 第二步，在Key的输入框输入已购买的代理IP业务AuthKey值（在业务列表中查看），点击测试按钮即可在右侧返回结果； 如下图所示：  其中，TaskID为申请时的任务ID，每次申请IP时生成的TaskID都是唯一的，该ID可用于IP释放操作； port为端口号需要在日常使用中加在IP后面，deadline为到期时间。
青果国内代理ip提供四种产品模式：短效代理、隧道代理、独享代理、静态代理。本文档为大家介绍4者的区别与特点，以此帮助大家选用更合适的产品。 | |
## 1 接口描述 接口地址： https://proxy.qg.net/monopolies 本接口是用于请求申请独占代理IP资源。 方法：POST； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :------- | :------- | :------ | :-------------------: | | Key | 是 | String | 申请独占资源的Key值 | | AreaCode | 否 | Integer | 地区编码，默认随机 | | Operator | 否 | Integer | 运营商，默认随机 | | Num | 否 | Integer | 数量，默认为1 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :------------: | | data | Array | 独占资源列表 | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl -X POST -d 'Key=请改成您的Key&AreaCode=XX&Operator=XXX&Num=1' 'https://proxy.qg.net/monopolies' ``` 返回示例： ``` { "data": [{ "uuid": "fj_qzdx9-1:ppp10", "area": “福建省泉州市”, "operator": "电信", "state": "排队(123)", //分成在线、离线、重拨中、排队中(等待秒数X) "monopolize_time": "2022-02-17 14:01:05", //独占时间 },{ ... }] } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------------: | | 201 | 创建成功 | | 400 | 独占资源不足 | | 400 | 通道数不足 | | 500 | 下放白名单失败 |
**简要描述：** 按量产品购买询价。 **输入参数：** |参数名|必选|类型|说明| |:---- |:---|:----- |----- | |spec_id |是 |integer |按量产品ID | |resource_number |否 |integer | 购买数量 | **输入示例：** - https://qg.net/api/Proxyip/getResourcePrice?spec_id=888&resource_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.点击如图位置图标，选择“Settings”  2.点击“Proxy”，勾选“Add a custom proxy configuration”，在Proxy Server处填入对应的代理IP和端口，设置Proxy Auth为“ON”即可在下方输入Username和Password。设置完成后关闭SETTINGS框即可 
```shell #!/bin/bash targetURL="https://test.ipw.cn" # 如果上面目标站不可用，请使用ip.sb、ipinfo.io、ip-api.com、64.ipcheck.ing proxyAddr="您的代理IP:端口号" authKey="请改成您的Key" password="请改成您的AuthPwd" curl -x ${authKey}:${password}@${proxyAddr} ${targetURL} -vvvv ```
|国家编码|国家中文|国家英文|青果编码| |:---- |:---|:----- |:----- | |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|
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 ## 步骤总览  ## 一、API鉴权与代理授权 青果支持开发者对API鉴权和代理授权验证进行自主管理，以下介绍这一阶段的操作 API鉴权指是指在访问API接口时对用户进行身份验证和权限检查，以确保API接口的安全性和可靠性。 用户可根据意愿选择开启和关闭API鉴权（默认关闭），青果提供的鉴权方式有密码和白名单两种，在对应业务【操作】-【业务设置】-【API鉴权】中进行设置即可。  代理授权验证是指对代理身份进行验证，只有通过对应信息才能使用该代理IP，确保您的使用权益和安全性。 青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。 相关入口和信息在业务管理页面可看到。  详细步骤可查看＞[如何使用API鉴权](https://www.qg.net/doc/2283.html)、[代理验证](https://www.qg.net/doc/1574.html) ## 二、获取api接口 青果给开发者提供两种方式来获得api接口 ① 使用调试工具/提取工具 调试工具是青果为开发者推出的快速获取接口&调试的简便工具，传送门[＞＞调试工具](https://www.qg.net/tools/IPdebug.html) 使用调试工具，用户需要先在左侧栏目中选好产品及接口类型，并在右侧表格的参数值列中填写所需信息，便可在页面上方看到完整的【请求地址】，这便是提取IP的API接口。 点击【发送】还能快速调试，查看响应结果，确认该代理接口是否可用。  调试工具除了有提取IP接口，还提供查询在用IP、资源池、资源地区等接口。 若只需要提取IP，也可以使用提取工具，进行简单的选择便可以获取一样的接口链接。传送门[＞＞提取工具 ](https://www.qg.net/tools/IPget.html)  ② 查看api接口文档 除了简便工具，开发者也可以通过更原始的接口文档，自主编写所需的接口链接。 **[点击查看API接口文档 ＞](https://www.qg.net/doc/product/6_258_274/2143.html)** ## 三、代理测试 在代理服务器中打开命令行，输入相应的代理信息进行运行，若响应成功，则代理可用。 以下图为例，通过curl命令测试账密模式的代理结果，查询IP并成功响应。 `curl -x http://{authkey}:{authpwd}@{118.92.69.112}:{32105} {targetUrl}`  若响应不成功，可对应[错误码表](https://www.qg.net/doc/1838.html)，排查问题。 ## 四、编写采集程序 测试代理可用后，便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例以及SDK下载包供开发者参考， 详情查看 - [SDK下载](https://www.qg.net/doc/sdk/9_230/1745.html) - [C语言代码示例](https://www.qg.net/doc/sdk/9_230/1694.html) - [Go语言代码示例](https://www.qg.net/doc/sdk/9_230/1695.html) - [PHP语言代码示例](https://www.qg.net/doc/sdk/9_230/1696.html) - [Python语言代码示例](https://www.qg.net/doc/sdk/9_230/1697.html) - [Java语言代码示例](https://www.qg.net/doc/sdk/9_230/1698.html) - [Shell语言代码示例](https://www.qg.net/doc/sdk/9_230/1699.html) - [C#语言代码示例](https://www.qg.net/doc/sdk/9_230/1700.html) - [Node语言代码示例](https://www.qg.net/doc/sdk/9_230/1701.html) **注：**青果代理IP产品都有相对应的IP存活周期，其有效时长是从提取到IP时算起，超过这个时长IP会失效。
## 1 产品简介 **全球HTTP均不支持在中国大陆地区网络环境下使用**。 短效代理（全球HTTP）提供全球60+个国家地区的海量IP资源，日去重量达到100万+。为您提供高质、可靠、稳定的代理服务，适用于公开数据采集的场景，助力企业融入数字经济发展浪潮。 在青果强大的技术支撑下，支持客户使用HTTP、HTTPS、Socks5 三大协议，多种语言脚本，保证您快速连接。 短效代理（全球HTTP）为用户提供了通道提取和按量提取两种方式，您可以从中选择适合自己业务的模式。 全球短效代理产品的使用非常方便，只需要几分钟，您可以通过编程使用或手动设置代理IP进行使用。 ## 2 提取方式 为满足不同用户的使用需求，全球HTTP-短效代理提供了2种不同的IP提取方式。 - [按量提取](https://www.qg.net/doc/product/6_259_283/2274.html)：【按使用的流数计费】适合流量使用不固定的应用场景 - [通道提取](https://www.qg.net/doc/product/6_259_283/2275.html)：【按同时在线的IP数计费】适用于对流量使用量较大的应用场景 ↑点击以上蓝字，查看该提取方式详情介绍（包含对应的套餐/IP存活时长介绍）。 不同的提取方式决定了不同计费方式，具体价格情况以购买页为准。 ## 3 产品优势 - 存活周期丰富，通道提取可选5-60分钟，按量提取可选1-3分钟，灵活适配用户需求； - 支持高并发，不限制并发请求数量； - 完美匿名本机IP，避免不必要的网络攻击，提升业务成功率。 - 可用性>99%，设置中转IP，保障可连续使用； - 支持账密&白名单两种鉴权方式，白名单IP最多支持256个； - 极速（访问百度测试，响应时间<1秒）； - IP存活时长到期后系统自动释放，无需手动释放； - 提供代理请求统计，包括请求频率、请求错误分析，帮助您自主排查，提升程序运行的成功率； - 提供IP提取、IP使用监控，精准回溯每一次的提取与使用记录； ## 4 产品属性 - 免费白名单数量：256 - 支持协议：HTTP/HTTPS/SOCKS5 - 单IP最大连接数：100 - 单IP带宽限制：2Mbps - 终端数限制：无限制 - 提取资源频率：通道提取为 (通道数*5+10 ) 次/分钟，按量提取为60次/分钟 - 单次提取IP上限：按量提取方式为200个，通道提取方式为100个 ## 5 用途 **短效代理（全球HTTP）可用于：** - 市场调研 - 品牌及版权保护 - 数据抓取和索引 - 跨境电商选品 - 夺取竞争对手情报 - SEO监控 **不适用于以下场景** - 大文档、音乐、视频等大文件下载； - 登录和访问色情、赌博等不健康的网站； - 用于网络攻击等违法行为。 ## 6 使用指南 短效代理（全球代理）使用非常方便，您可以选择①手动设置代理IP并在浏览器中使用， 也可以通过②API接口获取代理并参照代码样例集成到您的程序中。 具体请查看 - [手动设置代理指南 ＞](https://www.qg.net/doc/product/6_259_280/2264.html) - [开发者使用代理指南 ＞](https://www.qg.net/doc/product/6_259_280/2137.html) ## 7 产品购买 - [短效代理（全球HTTP）](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&pool_type=11&extract_mode=2&spec_idx=0&num_idx=0&time_idx=0&number=1&authkey_type=0 ) - [隧道代理（全球HTTP）](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3&pool_type=11&extract_mode=1&spec_idx=0&num_idx=0&time_idx=0&number=1&authkey_type=0)
