青果网络非常重视保护您的隐私。
为方便您登录、使用相关服务,以及为您提供更个性化的用户体验和服务,您在使用我们的服务时,我们可能会收集和使用您的相关信息。我们希望通过本隐私声明向您说明,在使用青果网络及 www.qg.net 服务(统称“本服务”)时,我们如何收集、使用、储存和披露您的信息,以及我们为您提供的访问、更新、控制和保护这些信息的方式。本隐私声明与您所使用的青果网络服务息息相关,希望您仔细阅读。
您使用我们的服务,即意味着您已经同意我们按照本隐私声明收集、使用、储存和披露您的相关信息,以及向您提供的控制和保护措施。
1.1 本隐私政策适用于青果网络所有服务。
1.2 第三方通过青果网络向您提供的服务,例如服务商通过青果网络向您提供服务时,收集和使用您的信息的,适用您和第三方之间关于个人信息和隐私的约定。
1.3本隐私声明中的“信息”特指第二条所收集的信息,本隐私政策不适用于您存储在青果网络系统中的数据
2.1 为完成青果网络账户的注册、管理、实名认证等必要活动,您需要提交真实、合法、有效的信息,包括但不限于姓名、电子邮箱、QQ 号码、联系电话、联系地址、银行账户信息、工商登记信息等。
2.2 为提供持续服务和保证服务质量所需,我们在您使用本服务期间,将记录并保存您登录和使用本服务的信息,包括但不限于 IP 地址、浏览器的类型、使用的语言、访问日期和时间、软硬件特征信息、用户标识符及网页浏览记录等。
2.3 如果您需要使用部分可选的青果网络功能或服务,如,网站备案、云市场等,您还应该提供使用该功能或服务所必须的信息,如联系人、联系方式、身份证照片等。
2.4 如果您需要在线上申请线下交付或进行产品测试,为履行合同所必需,您应提供联系人、联系方式、地址等必要信息。
2.5 如果您需要升级会员等级或进入云市场,为履行合同所必需,您应提供联系人、联系方式等必要信息。
3.1 我们通过您主动提交,以及在您使用我们的服务过程中产生相应的记录等方式收集您的信息。
3.2 我们可能会通过 Cookies 和其他相关技术收集和使用您的信息。我们使用 Cookies 的具体用途包括:
• 记住您的身份。例如:Cookies 有助于我们辨认您作为我们的注册用户的身份。
• 分析您使用我们服务的情况,以便为您提供更加周到的个性化服务,包括专属客服、推荐等服务。
3.3 您可以通过浏览器设置拒绝或管理 Cookies。但请注意,如果停用 Cookies,您有可能无法享受最佳的服务体验,某些功能的可用性可能会受到影响。
3.4 通过青果网络 Cookies 记录的有关信息,将适用本隐私声明。
为了向您提供更加优质、便捷、安全的服务,在符合相关法律法规的前提下,我们可能将收集的信息用作以下用途:
• 向您提供服务。
• 满足您的个性化需求。例如,语言设定、位置设定、个性化的帮助服务和指示,或对您和其他用户作出其他方面的回应。
• 服务优化和开发。例如,我们会根据青果网络系统响应您的需求时产生的信息,优化我们的服务。
• 保护青果网络、青果网络用户和青果网络的合作伙伴。例如,我们会将您的信息用于身份验证、安全防范、投诉处理、纠纷协调、诈骗监测等用途。例如,您在使用安全功能或其他类似服务时,我们会对恶意程序或病毒进行检测,或为您识别诈骗信息。
• 向您提供与您更加相关的服务。例如,向您提供您可能感兴趣的类似功能或服务等。
• 邀请您参与有关我们产品和服务的调查。
• 其他可能需要使用收集的信息的相关场景,如果使用场景与初始场景无合理的关联性,我们会在使用信息前重新征得您的同意。
未经您同意,我们不会与任何无关第三方分享您的信息,以下情形除外:
5.1 我们可能将您的信息与我们的关联公司、第三方服务提供商、承包商及代理分享,仅用作下列用途:
• 提供“二、信息收集范围”中的相应功能或服务所必需,以及出于“四、信息使用”中的部分所述目的所必需。
• 履行我们在《青果网络注册协议》或本声明中的义务和行使我们的权利。
如我们与任何上述第三方分享您的信息,我们将努力确保第三方在使用您的信息时遵守本声明及我们要求其遵守的其他适当的保密和安全措施。
5.2 随着我们业务的持续发展,我们以及我们的关联公司有可能进行合并、收购、资产转让或类似的交易,您的信息有可能作为此类交易的一部分而被转移。我们将遵守相关法律法规的要求,在转移前通知您,确保信息在转移时的机密性,以及变更后继续履行相应责任和义务。
5.3 我们还可能因以下原因而披露您的信息:
• 遵守适用的法律法规等有关规定。
• 遵守法院判决、裁定或其他法律程序的规定。
• 遵守相关政府机关或其他有权机关的要求。
• 我们有理由确信需遵守法律法规等有关规定。
• 为执行相关服务协议或本隐私声明、维护社会公共利益、处理投诉/纠纷,保护我们的客户、我们或我们的关联公司、其他用户或雇员的人身和财产安全或合法权益所合理必需的用途。
• 经过您合法授权的情形。
如我们因上述原因而披露您的信息,我们将在遵守法律法规相关规定及本声明的基础上及时告知您。
6.1 青果网络收集的有关您的信息保存在青果网络位于中国大陆的服务器。
6.2 通常,我们仅在为您提供服务期间保留您的信息,保留时间不会超过满足相关使用目的所必须的时间。
但在下列情况下,且仅出于下列情况相关的目的,我们有可能需要较长时间保留您的信息或部分信息:
• 遵守适用的法律法规等有关规定。
• 遵守法院判决、裁定或其他法律程序的要求。
• 遵守相关政府机关或其他有权机关的要求。
• 我们有理由确信需遵守法律法规等有关规定。
• 为执行相关服务协议或本隐私声明、维护社会公共利益、处理投诉/纠纷,保护我们的客户、我们或我们的关联公司、其他用户或雇员的人身和财产安全或合法权益所合理必需的用途。
7.1 如果您拥有青果网络其他账号,在特定场景下,您的青果网络账号的个人信息可能会与您在青果网络拥有的其他账户信息相关联。例如,您使用www.qgvps.com账号注册青果网络账号。
7.2 我们努力保障信息安全,以防信息的丢失、不当使用、未经授权阅览或披露。
• 我们使用各种安全技术以保障信息的安全。例如,我们将通过服务器多备份、密码加密等安全措施,防止信息泄露、毁损、丢失。
• 我们建立严格的管理制度和流程以保障信息的安全。例如,我们严格限制访问信息的人员范围,要求他们遵守保密义务。
• 我们重视信息安全合规工作,以业界先进的解决方案充分保障您的信息安全。
但请您理解,由于技术的限制以及可能存在的各种恶意手段,在互联网环境下,即便竭尽所能加强安全措施,也不可能始终保证信息百分之百的安全。您需要了解,您接入我们的服务所用的系统和通讯网络,有可能因我们可控范围外的因素而出现问题。
若发生个人信息泄露等安全事件,我们会启动应急预案,阻止安全事件扩大,按照《国家网络安全事件应急预案》等有关规定及时上报,并以发送邮件、推送通知、公告等形式告知您相关情况,并向您给出安全建议。
7.3 为更有效的保障您的信息安全,我们也希望您能够加强自我保护意识。我们仅在青果网络直接导致您个人信息泄露的范围内承担责任,因此,请您妥善保管您的账号及密码信息,避免您的个人信息泄露。青果网络账户有安全保护功能,但您也需要妥善保护自己的个人信息,除非您判断认为必要的情形下,不向任何第三人提供您的账号密码等个人信息。
8.1 您可以在使用我们服务的过程中,访问、修改和删除您的相关信息。您访问、修改和删除信息的方式将取决于您使用的具体服务。
8.2 如您发现我们违反法律法规的规定或者双方的约定收集、使用您的信息,您可以要求我们删除。如您发现我们收集、存储的您的信息有错误的,且无法自行更正的,您也可以要求我们更正。
8.3 在访问、修改和删除相关信息时,我们可能会要求您进行身份验证,以保障账户安全。请您理解,由于技术所限、基于法律法规要求,您的某些请求可能无法进行响应。
8.4 基于法律法规要求、保障信息安全等正当事由,您的部分信息可能无法访问、修改和删除。
8.5 您可以自行选择撤回对某些非基本功能或服务对您信息处理的同意,并通过联系客服的方式选择注销青果网络账号。
8.6 如您对上述权利实现存在疑问,可以根据“十、与我们联系”中的相关联系方式与我们取得联系。
我们可能适时修订本隐私声明的条款,该等修订构成本《隐私声明》的一部分。如可能造成您在本隐私声明下权利的实质减少或扩大收集、使用信息的范围等重要规则变更时,我们将在修订生效前通过在主页上显著位置提示或向您发送电子邮件或以其他方式通知您。在该种情况下,若您继续使用我们的服务,即表示同意受经修订的本隐私声明的约束。
如您对本政策或其他相关事宜有疑问,请根据我们提供的指引,填写相关资料,将您的问题发送至 tousu@qg.net 或寄到如下地址:
中国福建省泉州市丰泽区领SHOW天地传媒中心8楼(收)
邮编:362000
我们将尽快审核所涉问题,并在验证您的用户身份后的三十天内予以回复。
## 1 接口描述 接口地址:https://proxy.qg.net/query ; 本接口用于查询用户可用的代理IP资源列表; 该接口单个Key的请求频率限制为:(通道数*5+10)次/分钟; 方法:HTTP、GET,需要注意不能混合使用; 编码:参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |查询的Key值 | |TaskID |否 |String|任务ID;多个用","分割;默认全部 | |Detail |否 |Integer|详情,0:关闭;1:开启;默认为0 | ## 3 返回值 接口可返回json格式,字段说明如下: |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码,0:成功;-1:失败| |TotalNum |Integer |总IP数| |TaskNum |Integer |任务数| |TaskList |Array |任务列表| ## 4 示例 请求接口示例: ``` curl "https://proxy.qg.net/query?Key=请改成您的Key" ``` 返回示例: ``` { "Code": 0, "TaskList": [ { "TaskID": "91107E16D28AC5A", "Num": 1, "Data": [ { "IP": "127.0.0.1", "port": "21504", "deadline": "2022-11-18 15:06:05", "host": "114.231.8.147:21504" } ] } ], "TaskNum": 1, "TotalNum": 1 } ``` **重点:在共享企业池的产品中使用该接口,查询出来的IP资源Data结构中的host和IP是不一样的,其他产品下host和IP是一样的。企业池产品中用户使用host进行代理,这时真实的代理IP为IP字段的IP(运营商为移动的情况下可能不会那么准确,即使代理IP可能不通,也都是同一个地区的IP,影响不会大)** ## 5 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -100 | 计划不存在或已过期 |
本文将针对火狐浏览器如何使用代理IP进行详细说明,具体步骤如下: ## 1 代理IP信息查看 进入【控制台】,查看自己所购买的相对应的代理IP面板,点击【代理IP】-【查看详情】进行查看AuthKey以及AuthPwd信息; ![image-20221115092956709](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-15/0929581197607.png) ![image-20221115092903635](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-15/0929059a2bbec.png) ## 2 代理IP资源提取 在【控制台】-【代理IP】中的【提取工具】、【调试工具】又或者点击代理IP业务管理列表【操作】中的【提取IP】进行提取IP资源; ![image-20221119141451944](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-19/141453ec5ef30.png) 下图为【调试工具】提取IP,【接口类型选择】-【提取IP资源】填写所购买的代理IP的Key,点击【测试】,在右方即会显示所提取的IP资源详情; ![image-20221115092802349](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-11-15/09280386ce312.png) ## 3 在火狐浏览器中设置代理ip 在火狐浏览器右上角选择【菜单】-【选项】; ![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-04-25/1052106e60855.jpg) 选项中【常规】,下拉至【网络设置】选中【设置】; ![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-04-25/105213c6d3282.jpg) 选择【手动配置代理IP】, 填写您所购买的代理IP所对应提取的IP资源,勾选左下角,如果密码已保存,不在提示身份验证,点击【确认】即可; ![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-04-25/10521505c9e14.jpg) ## 4 身份验证 打开一个新网页,弹出此会话时,填写您购买代理IP业务所对应的AuthKey以及AuthPwd信息,点击【确认】即可; ![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-04-25/105218f9942fd.jpg) ## 5 验证是否配置成功 身份验证成功后,可直接在百度上进行查看IP是否为所提取的IP资源信息,现查看该IP为咱们所提取的IP资源,表示代理IP在火狐浏览器中配置成功。 ![img](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads/image/2022-04-25/10522176ef4bb.jpg)
## 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)
## 1 说明
通过编码使用隧道共享代理主要有以下两步骤:
(1)购买成功后,先在[会员中心](https://www.qg.net/user/ "会员中心")查看隧道信息,进行本地调试和验证;[查看测试步骤>>](https://www.qg.net/doc/1574.html "查看测试步骤>>")
(2)参考[代码样例](https://www.qg.net/doc/1879.html)请求隧道代理访问目标网站。
## 2 API接口
隧道共享代理API接口一览
| 接口类型 | API | 描述 |
| ---------- | --------------------- | ------------------ |
| 白名单相关 | - [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的白名单 |
**重点:**目前隧道代理仅支持IP白名单相关接口,隧道代理的使用主要参考[代码示例](https://www.qg.net/doc/1879.html "代码示例")。
**简要描述:** - 获取密钥信息 **输入示例:** - https://qg.net/api/proxyip/authkeyList **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "1":{ "Authkey": "按量的Key", "Authpwd": "218DBDA51A4C", "Remark": null, "Suid_list": [ { "Number": 10000, "Buy_time": "2021-03-17 09:47:34", "End_time": "2023-03-17 09:47:34", "Order_status": 1, "Type": 2, "Ip_type": 2, "Resource_available": 10000, "Resource_no": "SyqLAfghF" } ] }, "2":{ "Authkey": "按时的Key", "Authpwd": "xxxx", "Remark": null, "Suid_list": [ { "Suid": "crgrum1a", "Number": 1, "Buy_time": "2021-03-18 11:46:03", "End_time": "2021-04-18 11:46:03", "Order_status": 1, "Type": 2, "Ip_type": 2 } ] } }, "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Authkey |string |Authkey | |Authpwd |string |Authpwd | |Remark |string |备注 | |Suid_list |array |关联的业务列表| **关联的业务列表参数说明** |参数名|类型|说明| |:----- |:-----|----- | |Number |integer |按量:ip数;按时:通道数| |Connect |integer |IP类型为隧道时,连接数; IP类型为动态或静态时,连接数限制| |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 |按量业务余量 | |Resource_no |string |按量业务标识 | |Suid |string |按时业务标识 | **备注:** 更多返回错误代码请看首页的错误代码描述。
iPhone或ipad如何使用代理IP,本文将针对此问题进行详细说明,详细步骤如下: ## 1 查看业务信息 在【代理ip】-【业务管理】里面查看购买的代理业务,然后点击操作按钮【查看详情】查看代理业务的【AuthKey】跟【AuthPwd】,如下图: ![img](https://cos.qg.net/uploads/image/20210809/2789413dbfc3a3b23956137fa188f30c.png) ![img](https://cos.qg.net/uploads/image/20210915/3b9af98f5845da2ef30158742543fdde.png) ## 2 代理IP可行性测试 可以在浏览器输入“ip138.com”查看自己手机的ip地址,然后去【调试工具】选择【添加地址】输入【AuthKey】跟本机ip然后点击【测试】即可,如下图: ![img](https://cos.qg.net/uploads/image/20210915/84ba02075c7b08b74d9445603363758d.png) ![img](https://cos.qg.net/uploads/image/20210915/8ebe0aa79b5c6b41a520d85b20eecc9c.png) ## 3 申请IP 添加完成后,点击【资源申请】,然后输入key,获取ip,如下图: ![img](https://cos.qg.net/uploads/image/20210915/b86bde9e76f0414acdd918507c25d559.png) ### 4 使用代理IP 打开【设置】选择【无线局域网】,如下图: ![img](https://cos.qg.net/uploads/image/20210915/3dd12705c20d8d746d2bd2939a8a6507.png) 点完成后选择连接的【WIFI】,然后点击右边的感叹号; ![img](https://cos.qg.net/uploads/image/20210915/e224dd72d68f963294b5dd8b87ea0736.png) 点击后在新的界面选择【配置代理】,点击【手动】,输入申请的ip跟端口,点击【存储】即可; ![img](https://cos.qg.net/uploads/image/20210915/41faf4c4881ad11b5361fa2c33965182.png) ![img](https://cos.qg.net/uploads/image/20210915/d738458bc183247477025d2406e3a7ab.png) 使用浏览器打开浏览器打开ip138.com,查看ip是否和设置的代理ip相同,相同则为设置成功。 ![img](https://cos.qg.net/uploads/image/20210915/2166a884363cb45b58c9c44a53750ef8.png)
API调用频率跟IP的获取次数没有直接关系,API调用频率只是限制用户对我们API接口的使用频率限制; API接口包含了申请、释放、查询等多种操作,并非是只针对申请IP的限制,IP提取(获取)的频率只与用户选择的套餐类型和通道数有关。
青果隧道代理与其他形式的代理IP不同,不需要API接口即可连接使用代理IP,因此省去了获取IP和管理IP池等动作。以下介绍如何用代码方式,快速使用隧道代理。 ## 步骤总览 ![image-20240506110951591](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-05-06%2F110951e2b8889.png) ## 一、获取隧道地址 1.在青果完成产品购买后,就会自动进入控制后台,看到如以下的页面,产品列中就有隧道地址; ![image-20240429165920934](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-29%2F165921b79228f.png) **请注意,**目前国内代理IP和全球HTTP的产品,除了按量提取对应的套餐是按量业务之外,其他产品都属于按时业务。 ## 二、授权验证 获取到隧道地址之后,还需要有授权验证才能使用代理。隧道代理支持白名单和帐密两种验证方式,可自主选择使用。 白名单模式,即把要实现代理的服务器IP添加进代理白名单中,后续使用该IP连接代理就能成功; 账密模式,即先获取该代理业务的账号密码信息,连接代理时填入账密进行验证就可使用代理。 ![image-20240429170736889](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-29%2F170736df1d19c.png) 详细步骤可查看[代理验证 >](https://www.qg.net/doc/use/8_244/1574.html) ## 三、代理测试 在代理服务器中打开命令行,输入相应的代理信息进行运行,若响应成功,则代理可用。 以下图为例,通过curl命令测试账密模式的代理结果,查询IP并成功响应。 `curl -x http://{authkey}:{authpwd}@隧道地址 {targetUrl}` ![image-20240429171647434](https://public-1251015552.cos.ap-guangzhou.myqcloud.com/Uploads%2Fimage%2F2024-04-29%2F171647213d98a.png) 若响应不成功,可对应[错误码表](https://www.qg.net/doc/1838.html),排查问题。 ## 四、编写采集程序 测试代理可用后,便可开始编写代理采集程序了。 青果提供了多种编程语言的代码示例以及SDK下载包供开发者参考, 详情查看 - [SDK下载](https://www.qg.net/doc/sdk/9_230/1745.html) - [隧道代理 Go 语言接入指南](https://www.qg.net/doc/1872.html) - [隧道代理 Python 语言接入指南](https://www.qg.net/doc/1879.html) **注:**青果代理IP产品都有相对应的IP存活周期,其有效时长是从提取到IP时算起,超过这个时长IP会失效。
## 1 接口描述 接口地址:https://proxy.qg.net/extract ; 本接口用于获取IP资源池全部可用的IP信息,该接口仅按时动态共享业务可用; 该接口单个Key的请求频率限制为45次/分钟; 需要注意的是请求方方式只能用GET; 编码:参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 | 参数名 | 是否必选 | 类型 | 描述 | | :------- | :------- | :-------| ------- | | Key | 是 | String | 申请的Key值 | | Num | 否 | Integer | 申请的数量;默认为1 | | AreaId |否 | Integer | 区域ID;默认随机 | | ISP |否 | Integer | 运营商ID;默认随机 | | Detail | 否 | Integer | 详情,0:关闭;1:开启;默认为0 | ## 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/extract?Key=请改成您的Key&Pool=1&Detail=1" ``` 返回示例: ```json { "Code": 0, "Data": [ { "IP": "175.43.188.196", "port": "64450", "deadline": "2021-11-20 11:32:20", "host": "175.43.188.196:64450", "region": "福建省泉州市晋江市联通" }, { "IP": "114.238.148.203", "port": "50938", "deadline": "2021-11-20 11:32:20", "host": "114.238.148.203:50938", "region": "江苏省淮安市电信" }, { "IP": "117.92.121.222", "port": "11136", "deadline": "2021-11-20 11:32:20", "host": "117.92.121.222:11136", "region": "江苏省连云港市电信" } ], "Num": 3, "TaskID": "mw13Wq0srzt9uLEt" } ``` **重点:如果用户是企业池用户,且参数Pool=2,则返回的IP资源Data结构中的host和IP是不一样的,其他产品下host和IP是一样的。企业池产品中用户使用host进行代理,这时真实的代理IP为IP字段的IP(运营商为移动的情况下可能不会那么准确,即使代理IP可能不通,也都是同一个地区的IP,影响不会大)** ## 5 接口返回错误码 | 错误码 | 描述 | | ------ | ----------------------- | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -12 | Authkey被封禁 | | -13 | 当前客户端IP不在授权名单中 | | -14 | Pwd不合法 | | -15 | Authkey对应的业务无此功能权限 | | -100 | 计划不存在或已过期 | | -101 | 请求数量超过计划通道数 | | -103 | 资源不足 | | -104 | 资源申请失败 |