## 1 接口描述 接口地址： https://proxy.qg.net/resources ； 本接口用于查询平台可用的代理IP资源列表； 该接口单个Key的请求频率限制为：60 次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |查询的Key值 | |AreaId |否 |String|区域编号 | |Isp |否 |Integer|运营商编号 | |Status |否 |Integer|可用状态，0:不可用；1:可用 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码，0：成功；-1：失败| |Data|Array| 资源列表 | ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/resources?Key=请改成您的Key" ``` 返回示例： ``` { "Code": 0, "Data": [ { "AreaId": "350500", "AreaName": "福建泉州市", "Isp": "1", "IspName": "电信", "Status": "1" } ] } ``` ##5 接口返回错误码 | 错误码 | 描述 | | ---- | ------------- | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | AuthKey被封禁 | | -15 | Authkey对应的业务无此功能权限 | | -100 | 计划不存在或已过期 |
## 1 API调用提取 对于短效代理、独享代理、静态代理，我们都提供了API接口，方便开发者批量获取代理IP。 接口返回数据的格式支持文本、json、xml。 获取IP接口文档： - [短效代理IP资源提取 ＞](https://www.qg.net/doc/2255.html) - [独享代理IP资源提取 ＞](https://www.qg.net/doc/1840.html) - [静态代理IP资源提取 ＞](https://www.qg.net/doc/1863.html) 隧道代理无需调用API提取代理，其他接口参见：[API接口概览](https://www.qg.net/doc/2145.html) ## 2 生成API链接 你可以在【提取工具】或【调试工具】生成API链接在线提取IP，方便集成到您的程序或软件中。 ### 2.1 提取工具 选择已购买可用的AuthKey值,根据实际需求提取对应的IP，点击【生成链接】获取在线API链接，【打开链接】新窗口打开获取申请成功的IP信息，如下图所示；   ### 2.2 调试工具 首先勾选要进行提取的业务key，key为必选项，是对接接口的必要信息； 其次，选择接口方法，不同的产品可选择的提取接口不同。 短效代理可选择【提取IP资源】、【获取IP池资源】接口，接口【获取IP池资源】是获取IP资源池全部可用的IP，资源池指的是购买短效代理的多通道形成的小资源池； 独享代理提取接口可选择【提取IP资源】、【更换IP资源】，接口【更换IP资源】是释放IP并申请新的IP； 静态代理提取接口可选择【提取IP资源】； 然后，其他选项IP数量、地区、运营商按需选择，最后点击【测试】按钮即可进行IP提取,申请成功返回结果为如下图所示；  ## 3 测试API链接 ### 3.1 浏览器测试 您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接： https://proxy.qg.net/query?Key=0B***607 ###3.2 命令行测试 如果您在linux系统下，可以通过curl命令请求API链接查看结果： ``` curl "https://proxy.qg.net/allocate?Key=请改成您的Key ``` ## 4 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -100 | 计划不存在或已过期 | | -101 | 请求数量超过计划通道数 | | -102 | 没有剩余的可用通道 | | -103 | 资源不足 | | -104 | 资源申请失败 | | -105 | 申请的IP数超过允许申请的IP数 | 每个接口自己的错误码请参见各接口文档。 ## 5 代码样例 - [代码示例-Python](https://www.qg.net/doc/81.html) - [代码示例-Java](https://www.qg.net/doc/82.html) - [代码示例-PHP](https://www.qg.net/doc/83.html)
<p style="margin: 0px 0px 10px; padding: 0px; box-sizing: border-box; line-height: 1.5; list-style: inherit; color: #333333; font-family: PingFangSC-Light, 'helvetica neue', arial, 'hiragino sans gb', 'microsoft yahei ui', 'microsoft yahei', simsun, sans-serif;">根据工信部要求，目前工信部可接受备案域名后缀：</p> <p style="margin: 0px 0px 10px; padding: 0px; box-sizing: border-box; line-height: 1.5; list-style: inherit; color: #333333; font-family: PingFangSC-Light, 'helvetica neue', arial, 'hiragino sans gb', 'microsoft yahei ui', 'microsoft yahei', simsun, sans-serif;">英文域名：<br style="padding: 0px; margin: 0px; box-sizing: border-box;" />.cn/.ren/.wang/.citic/.top/.sohu/.xin/.com/.net/.xyz/.vip/.work/.law/.beer/.club/.shop/.site/.ink/.info/.mobi/.red/.pro/.kim/.ltd/.group/.auto/.link/.biz/.fun/.online/.store/.tech/.art/.design/.wiki/.love/.center/.video/.social/.team/.show/.cool/.zone/.world/.today/.city/.chat/.company/.live/.fund/.gold/.plus/.guru/.run/.pub/.email/.life<br style="padding: 0px; margin: 0px; box-sizing: border-box;" />中文域名：<br style="padding: 0px; margin: 0px; box-sizing: border-box;" />.中国/.公司/.网络/.政务/.公益/.政务.CN/.公益.CN/.网址/.商城/.网店/.中信/.商标/.信息/.广东/.佛山/.集团/.我爱你/.网店/.手机/.购物/.在线/.中文网/.游戏/.企业/.娱乐/.商店/.餐厅/.招聘</p> <p style="margin: 0px 0px 10px; padding: 0px; box-sizing: border-box; line-height: 1.5; list-style: inherit; color: #333333; font-family: PingFangSC-Light, 'helvetica neue', arial, 'hiragino sans gb', 'microsoft yahei ui', 'microsoft yahei', simsun, sans-serif;">除以上域名，其他域名后缀均无法在工信部进行备案。</p> <p style="margin: 10px 0px; padding: 0px; box-sizing: border-box; line-height: 1.5;"> </p>
API调用频率跟IP的获取次数没有直接关系，API调用频率只是限制用户对我们API接口的使用频率限制； API接口包含了申请、释放、查询等多种操作，并非是只针对申请IP的限制，IP提取（获取）的频率只与用户选择的套餐类型和通道数有关。
## 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 "资源申请")
- [replace](https://www.qg.net/doc/297.html "更换IP资源")
- [release](https://www.qg.net/doc/176.html "释放资源")
- [query](https://www.qg.net/doc/175.html "资源查询")
| - 调用 allocate提取代理IP资源
- 调用replace用于释放并申请新的代理IP，更换IP资源
- 调用release释放申请到的IP，以便于再次进行IP申请
- 调用query查询用户可用的代理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/del") | - 调用 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提取余量
- 调用resources查询平台可用的代理IP资源列表 |
**重点：**动态独享代理只提供给单个客户使用，独享带宽和IP资源，IP可自主释放申请，因此新增接口更换IP资源/replace、释放IP资源/release。
## 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/replace ； 本接口用于替换代理IP； 该接口单个Key的请求频率限制为：（通道数*5）+10 次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |更换IP的Key值 | |KeepAlive |否 |Integer|存活周期；默认动态独享24小时,动态共享默认购买的套餐存活周期时长 | |AreaId |否 |Integer|区域ID；默认随机 | |ISP |否 |Integer|运营商ID；默认随机 | |Num |否 |Integer |申请数量，默认为全部| |Detail |否 |Integer|详情，0：关闭；1：开启；默认为0| |Distinct|否|Integer| 去重，0：关闭；1：开启；默认为0| |DataFormat |否 |String|数据格式，本接口取值：json、html、text ；默认为 json格式| |DataSeparator |否 |String|分隔符，自定义| ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码，0：成功；-1：失败| |TaskID |Integer |任务ID| |Num |Intger |申请数量| |Data |Array | 代理IP数据信息，包含节点IP、端口、失效日期 | |Msg |String |区域ID | ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/replace?Key=请改成您的Key" ``` 返回示例： ```json { "Code": 0, "TaskID": "91107E16D28AC5A", "Num": "1", "Data": [ { "IP": "127.0.0.1", "port": "49168", "deadline": "2018-05-11 02:56:02", "host": "127.0.0.1:49168" } ] } ``` ## 5 接口返回错误码 | 错误码| 描述 | | ---- | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -13 | 当前客户端IP不在授权名单中 | | -14 | Pwd不合法 | | -15 | Authkey对应的业务无此权限 | | -100 | 计划不存在或已过期 | | -103 | 资源不足 | | -104 | 申请资源失败 | | -105 | 释放的IP数超过允许释放的IP数 |
Sockscap64是一款代理客户端软件，可以使Windows网络应用程序来访问网络而不需要对这些应用程序做任何修改。 本文将针对代理客户端SocksCap64使用教程进行详细的说明，具体步骤如下： 软件安装包下载地址，下载后操作安装软件； https://www.onlinedown.net/download/254774?module=download&t=website&resources=0 打开软件，发现你还未添加任何程序时会自动提醒你是否需要自动导入你电脑中安装的浏览器， 选择【是】，可以自动导入；  点击【代理】；  点击如图所示图标；  编辑代理服务器信息；  编辑完成后点击如图所示图标，可测试代理连接；  测试正常即可点击【保存】；  点击程序下拉菜单，选择【添加一个可执行文件】可添加指定程序；  在弹出的窗口中设置好对应程序，然后点击【确定】；  右键点击指定程序，选择【在代理隧道中运行选中程序】即可； 
此示例Python使用Selenium调用Chrome浏览器并通过代理进行自动化测试。 - 代码示例 ```python from selenium import webdriver from selenium.webdriver.chrome.service import Service targetURL = "http://myip.ipip.net" #访问的目标站点 proxyAddr = "您的代理IP:端口号" if __name__ == '__main__': browser_location = r".\Chrome\chrome.exe" #指定浏览器路径位置 driver_location = r".\Chrome\chromedriver.exe" #指定Driver路径位置 option = webdriver.ChromeOptions() option.binary_location = browser_location #设置浏览器位置 option.add_argument("--start-maximized") #窗口最大化运行 option.add_argument('--proxy-server=%(server)s' % {"server": proxyAddr}) driver = webdriver.Chrome(service=Service(driver_location), options=option) driver.get(targetURL) print(driver.page_source) ``` - 运行结果 
青果为有经验的开发者提供多种API接口及代码示例，以协助开发者更便利地使用代理。 本篇仅以【提取IP】这一操作为例，介绍如何使用API接口-代码方式来使用代理。 ## 步骤总览  **注：若使用白名单验证模式，请先添加白名单再进行API接口获取。** ## 一、获取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_255_263_264/2254.html)、[按量提取类型](https://www.qg.net/doc/product/6_255_263_265/2140.html)、[均匀提取类型](https://www.qg.net/doc/product/6_255_263_266/2258.html)、[通道提取类型](https://www.qg.net/doc/product/6_255_263_267/2139.html)** ## 二、授权验证 正式使用代理之前，还需要通过授权验证。青果代理IP支持白名单和帐密两种验证方式，可自主选择使用。 白名单模式，即把要实现代理的服务器IP添加进代理白名单中，后续使用该IP连接代理就能成功； 账密模式，即先获取该代理业务的账号密码信息，连接代理时填入账密进行验证就可使用代理。  详细步骤可查看＞[代理验证](https://www.qg.net/doc/1574.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会失效。
