## 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 | 下放白名单失败 |

## 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 请求结构 服务地址：目前支持的域名列表为: |接口域名|域名| |:---- |:---| |请求域名 |proxy.qg.net| ## 2 公共参数 公共参数是用于标识用户和接口的参数，如非必要，在每个接口单独的接口文档中不再对这些参数进行说明，但每次请求均需要携带这些参数，才能正常发起请求。 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Method |是 |String|具体操作的指令接口名称，例如想要调用查询代理IP列表接口，则Method参数即为query。 |Key |是 |String |在 https://www.qg.net 上购买代理IP后得到的标识身份的密钥Key。 |Num |否 |Integer|数量 |KeepAlive |否 |Integer|生存周期(单位分钟) | |AreaId |否 | Integer|区域编号(参考区域编号数据表) | |detail |否 |Integer|是否查看详情(可查看到具体的省市县信息) | |IP |否 | String| 节点IP，多个用"，"分割；全部以"* "表示 |Isp |否 | String| 运营商，默认随机，1:电信；2:移动；3:联通；4:BGP |TaskID |否 |String|任务ID，多个用"，"分割；全部以"* "表示 假设用户想要查询已申请的代理IP列表(其中Method为query)，则其请求链接的形式可能如下: https://proxy.qg.net/query?Key=密钥 ## 3 接口请求频率 接口频率限制时间均为一分钟内，从触发某个接口的时间开始计时的一分钟。具体详情如下： | 接口类型 | 频率限制 | | :------------ | :------------ | | /allocate 提取IP资源 | 按时：通道数*5+10，按量：60 | | /replace 更换IP资源 | 按时：通道数*5+10 | | /extract 获取IP资源池 | 动态共享按时：45 | | /release 释放IP资源 | 动态独享按时：通道数*5 | | /query 查询IP资源 | 按时：通道数*5+10 | | /whitelist/add 添加白名单 | 20 | | /whitelist/del 删除白名单 | 20 | | /whitelist/query 查询白名单 | 60 | | /info/quota 通道配额| 60 | | /resources 区域查询 | 60 | ## 4 释放次数限制 | 套餐类型 | 释放次数限制说明 | | ------------ | ------------ | | 动态独享 | 每分钟的释放限制次数为通道数*2 | | 动态共享 | 不能自主释放，套餐时长到期后自动释放 | | 静态独享 | 超过一天后能释放，一周不超过2次 | | 动态独占 | 添加的资源要12小时后才能更换 | ## 5 通信协议 青果云代理IP-API的所有接口均支持HTTP、HTTPS进行通信，提供高安全性的通信通道。 ## 6 请求方法 同时支持 POST 和 GET 请求，需要注意不能混合使用。即如果使用 GET 方式，则参数均从 Querystring 取得；如果使用 POST 方式，则参数均从 Request Body 中取得，Querystring 中的参数将忽略。两种方式参数格式规则相同，一般使用GET，当参数字符串过长时使用POST，请见各接口详细描述。 ## 7 字符编码 均使用UTF-8编码。

## 1 接口描述 接口地址： https://proxy.qg.net/monopolies 本接口是根据key查询用户已占用到且可用的独占资源列表。 请求频率限制：60次/分钟； 方法：GET； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :----- | :------- | :----- | :----------------------------: | | Key | 是 | String | 查询独占资源的Key值； | | UUIDs | 否 | String | 独占资源编号，多个用逗号隔开。 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： | 返回字段 | 类型 | 描述 | | :------- | :----- | :----------: | | data | Array | 独占资源列表 | | error | String | 错误信息 | ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/monopolies?Key=请改成您的Key&UUIDs=XXX,XXX" ``` 返回示例： ``` { "data": [{ "uuid": "fj_qzdx9-1:ppp10", "area": "福建省泉州市", "isp": "电信", "state": "在线", //分成在线、离线、重拨中、排队中(等待秒数X) "monopolize_time": "2022-02-17 14:01:05", //独占时间 "last_dial_time": "2022-02-17 14:01:05", //最近一次拨号时间 "ip": "127.0.0.1:10800", //当前IP，状态为在线时才有此数据 "heartbeat": "2022-02-17 14:01:05", //最后一次心跳，状态为在线时才有此数据 },{ ... }] } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | :----: | :------: | | 200 | 查询成功 | | 500 | 未知错误 |

## 1 接口描述 接口地址： https://proxy.qg.net/info/quota 本接口用于查询IP提取余量。 该接口单个Key的请求频率限制为：60次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |查询的Key值 | ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码| |Total |Integer |总数量| |Available|Integer |可用数量| |Used |Integer |已使用数量| ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/info/quota?Key=请改成您的Key" ``` 返回示例： ``` { "Code": 0, "Total": 5, "Available": 3, "Used": 2 } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | AuthKey被封禁 | | -100 | 计划不存在或已过期 |

## 1 接口简介 青果代理IP提供了功能丰富的API接口，满足开发者在各种场景下的调用需求。 所有接口支持 HTTP 或者 HTTPS 请求，部分接口采用 GET 方法，部分接口采用 POST 方法；接口返回数据的格式支持文本、json、xml。 具体请参见接口文档。 ## 2 API列表 - [动态共享代理](https://www.qg.net/doc/1564.html "动态共享代理") - [动态独享代理](https://www.qg.net/doc/1565.html "动态独享代理") - [动态独占代理](https://www.qg.net/doc/1570.html "动态独占代理") - [隧道共享代理](https://www.qg.net/doc/1567.html "隧道共享代理") - [静态独享代理](https://www.qg.net/doc/1568.html "静态独享代理") ## 3 测试代理可用性 ### 3.1 生成API链接 对于代理提取API，您可以到提取工具在线生成API链接，内置到您的程序中： [提取代理API链接生成 ＞](https://www.qg.net/tools/IPget.html "提取代理API链接生成 ＞＞") 其他接口请查看API文档，获取接口url和参数说明，自己生成API链接。 ### 3.2 测试API链接 **浏览器测试** 您可以把生成的API链接直接在浏览器里打开，查看返回结果。例如，您直接点击如下api链接 https://proxy.qg.net/query?Key=0B***607 **命令行测试** 如果您在linux系统下，可以通过curl命令请求API链接查看结果： `curl "https://proxy.qg.net/allocate?Key=请改成您的Key"` ## 4 接口返回错误码 公共接口返回错误码 | 错误码 | 描述 | | ------ | ------------------------- | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -13 | 当前客户端IP不在授权名单中 | | -14 | Pwd不合法 | | -15 | Authkey对应的业务无此权限 | | -100 | 计划不存在或已过期 | | -103 | 资源不足 | | -104 | 申请资源失败 | | -105 | 释放的IP数超过允许释放的IP数 | ## 5 代码样例 查看API调用的[代码样例 ＞](https://www.qg.net/doc/172.html)

下载并安装好SocksDroid这个apk软件，软件详情如下图：  方框1填入申请到的IP，方框2填入申请到IP的端口；  方框3填写AuthKey，方框4填写AuthPwd，填写完毕后滑动方框5 即可；  出现这个小钥匙代表连接成功，可以使用浏览器搜索一下IP 显示的就是代理的IP。 

Proxifier是一款代理客户端软件，可以让不支持代理服务器工作的程序变的可行。支持各种操作系统和各代理协议，它的运行模式可以指定端口，指定程序的特点。 本文将针对代理客户端Proxifier使用教程进行详细的说明，具体步骤如下： 软件安装包下载地址：https://www.onlinedown.net/download/971579?module=download&t=website&resources=0 ，下载后操作安装软件； 打开软件，点击菜单栏【配置文件】中的【代理服务器】；  在弹出的窗口中点击【添加】；  输入代理服务器地址，点选协议，若使用账密方式连接则启用验证，然后输入用户名和密码。然后点击【检查】；  若提示测试已通过则说明配置正确可以使用；  在代理服务器设置界面点击【确定】即可；  点击【是】；  点击【确定】，此时就已连接上代理了；  若需要配置代理规则可以点击菜单栏【配置文件】中的【代理规则】；  点击【编辑】；  应用程序处点击【浏览】可以设置指定程序，目标端口处可以设置指定端口，设置完成后点击【确定】即可。 

Sockscap64是一款代理客户端软件，可以使Windows网络应用程序来访问网络而不需要对这些应用程序做任何修改。 本文将针对代理客户端SocksCap64使用教程进行详细的说明，具体步骤如下： 软件安装包下载地址，下载后操作安装软件； https://www.onlinedown.net/download/254774?module=download&t=website&resources=0 打开软件，发现你还未添加任何程序时会自动提醒你是否需要自动导入你电脑中安装的浏览器， 选择【是】，可以自动导入；  点击【代理】；  点击如图所示图标；  编辑代理服务器信息；  编辑完成后点击如图所示图标，可测试代理连接；  测试正常即可点击【保存】；  点击程序下拉菜单，选择【添加一个可执行文件】可添加指定程序；  在弹出的窗口中设置好对应程序，然后点击【确定】；  右键点击指定程序，选择【在代理隧道中运行选中程序】即可； 

Sstap是一款代理客户端软件。本文将针对代理客户端SSTap使用教程进行详细的说明，具体步骤如下： 软件下载地址：https://github.com/solikethis/SSTap-backup ，下载后解压文件；  第一次打开软件，提示如图信息，点击【安装】；  点击【添加HTTP/SOCK4/SOCK5代理】；  设置代理类型，输入连接信息，点击【保存】即可；  点击【模式】，选择所需的模式，示例中选择【仅网页浏览器（全局）】，然后点击【连接】；  连接成功后提示--已连接！