## 概述 本文档将指引你进行隧道代理的接入，在此文档中使用到的术语将会在下方进行列出。 | 术语 | 解释 | | :------- | :----------------------------------------- | | 隧道 | 自动更换代理 IP 的代理服务 | | 固定时长 | 服务器将在固定时长后自动切换IP，例如1分钟 | | 通道 | 使用多个通道同时发起请求，每个通道的IP不同 | 隧道代理有多种使用方式，具体行为取决于套餐及模式。 - 普通模式 每次请求都自动切换IP - 普通模式指定地区 普通模式下，希望可以指定地区（仅适用于全球HTTP隧道代理），具体参考[海外区域编码](https://www.qg.net/doc/1975.html "海外区域编码")中的青果编码。 - 普通模式打标记 普通模式下，希望多个HTTP请求保证代理IP相同，可以给多个请求的代理协议打上相同的标记，并标记这个代理IP的存活时间（不主动设置存活时间则默认为10秒） - 固定时长多通道模式 服务器定时切换IP，可同时使用多个通道发起请求，即可以同时使用多个IP ## 前置知识 在 Python 语言中，通常使用 requests 进行 http/s 代理的设定与请求的发送 ### Proxy Url Scheme 由协议、用户名、密码、域名、端口几部分组成 例如 http 协议的代理 url ``` http://[user:password@]hostname:port ``` ### pip Python 的包管理工具，可以简单的进行依赖管理 ## 使用 Python 接入 **以下内容假设读者具备基本的 Python 使用经验和对网络协议具有一定的了解。** ### 安装 requests ```shell pip3 install requests ``` ### 生成 url 普通模式 ```python proxyUrl = "http://%(user)s:%(password)s@%(server)s" % { "user": authKey, "password": password, "server": proxyAddr, } ``` 普通模式指定地区（仅适用于全球HTTP隧道代理） ```python proxyUrl = "http://%(user)s:%(password)s:A%(area)d@%(server)s" % { "user": authKey, "password": password, "server": proxyAddr, "area": area, } ``` 普通模式打标记 ```python proxyUrl = "http://%(user)s:%(password)s:%(channel)s:%(ttl)d@%(server)s" % { "user": authKey, "password": password, "channel": "channel-1", "ttl": 20, "server": proxyAddr, } ``` 固定时长多通道模式（该模式仅适用于2024年5月17日前购买的隧道代理固定时长多通道产品） ```python proxyUrl = "http://%(user)s:%(password)s:%(channel)s@%(server)s" % { "user": authKey, "password": password, "channel": "channel-1", "server": proxyAddr, } ``` ### 设置代理地址 http/s 均适用该地址 ``` proxies = { "http": proxyUrl, "https": proxyUrl, } ``` ### 执行 HTTP/s 请求 以 https://api.ipify.org 为例 ```python resp = requests.get("https://ip.cn/api/index?ip=&type=0", proxies=proxies) ``` ### 读取响应实体 resp.text 是字符串类型，可以直接打印 ```python print(resp.text) ``` ## 示例代码 ```python import requests proxyAddr = "" authKey = "" password = "" proxyUrl = "http://%(user)s:%(password)s@%(server)s" % { "user": authKey, "password": password, "server": proxyAddr, } proxies = { "http": proxyUrl, "https": proxyUrl, } resp = requests.get("https://api.ipify.org", proxies=proxies) print(resp.text) ```
## 1 接口描述 接口地址： https://proxy.qg.net/whitelist/query ； 本接口用于查询IP的白名单。 该接口单个Key的请求频率限制为：60次/分钟； 方法：HTTP、GET，需要注意不能混合使用； 编码：参数和返回内容均采用utf-8编码。 ## 2 输入参数说明 |参数名|是否必选|类型|描述| |:---- |:---|:----- |----- | |Key |是 |String |查询白名单的Key值 |TaskID |是 |Integer |任务编号ID |detail |是 |Integer |详情0(关闭) 1(开启) ## 3 返回值 接口可返回文本格式、json格式、xml格式，字段说明如下： |参数名|类型|描述| |:---- |:----- |----- | |Code |Integer |结果编码，0：成功；-1：失败 |Num |Integer |数量 |Data |Array |IP白名单列表 ## 4 示例 请求接口示例： ``` curl "https://proxy.qg.net/whitelist/query?Key=请改成您的Key" ``` 返回示例： ``` { "Code": 0, "Num": 2, "Data": [ "192.168.1.1", "192.168.1.2" ] } ``` ## 5 接口返回错误码 | 错误码 | 描述 | | ------------ | ------------ | | -1 | 未知错误 | | -10 | 参数不合法 | | -11 | 请求过于频繁 | | -100 | 计划不存在或已过期 |
## 1 产品简介 隧道代理是利用高性能主机构建的动态代理服务器，通过将切换IP的操作放到云端，自动管理用户发出的隧道请求，实现云端切换IP转发用户请求，简化用户的操作，降低了用户的时间成本； 隧道代理默认每秒允许5个并发请求限制起，支持短期高并发。 隧道代理使用简单，开发者接入隧道服务即可，参照【[代码样例](https://www.qg.net/list/192.html)】可集成到您的程序中，极大简化了编程的复杂度。  ## 2 产品优势 - 无须提取IP，方便快捷； - 采用弹性并发数控制，支持短期高并发使用； - 提供可视化监控统计，帮助用户精准把控请求频率走势，提升业务运行的成功率； - 完美匿名本机IP，避免不必要的网络攻击，提升业务成功率。 - 云端切换IP，连接上我们的隧道代理服务器后，统一入口，随机动态出口IP，无需手动切换 ； - 隧道代理可用性>99%，若转发的IP不可用，隧道代理会自动再转发到1个新的可用IP，可连续使用； - 响应极速，毫秒级更换代理IP（访问百度测试，响应时间<1秒）； - 支持多台设备或进程同时进行。 ## 3 适合人群 隧道代理适用于需要调用简单的应用场景。 ## 4 IP存活时长 每一个请求随机一个IP。 ## 5 付费模式 目前仅支持按时计费模式，包括按日、按周、按月、按年四种按时付费模式。 ## 6 产品属性 - 免费白名单数量：256 - 支持协议：HTTP/HTTPS/SOCKS5 - 带宽限制：1Mbps/IP - 终端数限制：无限制 ## 7 用途 **隧道代理可用于：** - 征信查询 - 原创版权保护 - 电商选品 - 拓客数据 **不适用于以下场景** - 访问谷歌等国内正常无法访问的网站； - 大文档、音乐、视频等大文件下载； - 登录和访问色情、赌博等不健康的网站； - 用于网络攻击等违法行为。 ## 8 使用指南 隧道代理最主要的使用方式是编程使用，无须提取IP，对接隧道服务即可。 [查看隧道代理（动态请求）开发者指南 ＞](https://www.qg.net/doc/product/6_256_269/1796.html) ## 9 产品购买 - [短效代理 ＞](https://www.qg.net/business/proxyip/2.html?region=domestic&product_type=1&pool_type=2&extract_mode=4&spec_idx=0&num_idx=0&time_idx=3&number=1000&authkey_type=0 ) - [隧道代理 ＞](https://www.qg.net/business/proxyip/42.html?region=domestic&product_type=3&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=3&number=5&authkey_type=0 ) - [独享代理 ＞](https://www.qg.net/business/proxyip/6.html?region=domestic&product_type=2&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=2&number=1&authkey_type=0) - [静态代理 ＞](https://www.qg.net/business/proxyip/6.html?region=domestic&product_type=4&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=2&number=1&authkey_type=0 )
下载并安装好SocksDroid这个apk软件，软件详情如下图：  方框1填入申请到的IP，方框2填入申请到IP的端口；  方框3填写AuthKey，方框4填写AuthPwd，填写完毕后滑动方框5 即可；  出现这个小钥匙代表连接成功，可以使用浏览器搜索一下IP 显示的就是代理的IP。 
## 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接口进行提取IP等调用，但提供白名单功能的API接口。
| 接口类型 | 接口 |
| ---------- | --------------------- | ------------------ |
| 白名单相关 | [添加白名单IP](https://www.qg.net/doc/178.html "添加白名单IP")
[删除白名单IP](https://www.qg.net/doc/179.html "删除白名单IP")
[查询白名单IP](https://www.qg.net/doc/180.html "[查询白名单IP]")
**重点：**目前隧道代理仅支持IP白名单相关接口，隧道代理的使用主要参考[代码示例](https://www.qg.net/doc/1879.html "代码示例")。
## 1 产品简介 独享是用户独享带宽和IP资源，IP稳定不易掉线，带宽峰值高达**5Mbps**，极速响应；一人独享IP池，保障IP纯净度与业务成功率；节点广，可自由选定IP地区和存活时长，支持多机器或多进程使用代理IP，灵活满足业务需求； 独享代理使用非常方便，只需几分钟，您就可以通过[API链接](https://www.qg.net/tools/IPget.html?type=2-1)获取代理IP并参照[代码样例](https://www.qg.net/list/192.html)集成到您的程序中。 ## 2 产品优势 - IP存活时长≤24H，IP存活30秒后可释放申请新的IP，可根据需求，自主控制IP时长； - 独享带宽和IP，能有效的保证IP的纯净度和业务的成功率； - 5Mbps带宽，高速、不限流量； - 提供代理请求统计，包括请求频率、请求错误类型等，帮助自主排查，提升程序运行的成功率； - 提供IP提取监控，精准回溯每一次的提取记录； - 极速（访问百度测试，响应时间<1秒） - 支持多台设备或多个进程同时进行 - 覆盖全国主要省份 - 支持指定获取某个城市IP或全国随机 ## 3 适合人群 独享代理适用于对IP质量要求较高或对带宽要求较高的业务场景。 ## 4 计费模式 目前仅支持按时计费模式，包括按周、按月、按年三种按时付费模式 ## 5 产品属性 - 免费白名单数量：256 - 支持协议：HTTP/HTTPS/SOCKS5 - 单IP最大连接数：1000 - 带宽峰值：5Mbps - 终端数限制：无限制 - 提取资源频率： (通道数*5+10 ) 次/分钟 - 单次提取IP上限：100个 ## 6 用途 **独享代理可用于：** - 广告检测 - 征信查询 - 拓客数据 - 直播/短视频数据监控分析 - SEO检测 **不适用于以下场景** - 访问谷歌等国内正常无法访问的网站； - 大文档、音乐、视频等大文件下载； - 登录和访问色情、赌博等不健康的网站； - 用于网络攻击等违法行为。 ## 7 使用指南 独享代理使用非常方便，您可以选择①**手动设置**代理IP并在浏览器中使用， 也可以通过②**API接口获取**代理并参照代码样例集成到您的程序中。 具体请查看 - [手动设置代理指南 ＞](https://www.qg.net/doc/product/6_257_270/2266.html) - [开发者使用代理指南 ＞](https://www.qg.net/doc/product/6_257_270/1794.html) ##8 产品购买 - [短效代理 ＞](https://www.qg.net/business/proxyip/2.html?region=domestic&product_type=1&pool_type=2&extract_mode=4&spec_idx=0&num_idx=0&time_idx=3&number=1000&authkey_type=0 ) - [隧道代理 ＞](https://www.qg.net/business/proxyip/42.html?region=domestic&product_type=3&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=3&number=5&authkey_type=0 ) - [独享代理 ＞](https://www.qg.net/business/proxyip/6.html?region=domestic&product_type=2&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=2&number=1&authkey_type=0) - [静态代理 ＞](https://www.qg.net/business/proxyip/6.html?region=domestic&product_type=4&pool_type=1&extract_mode=1&spec_idx=0&num_idx=0&time_idx=2&number=1&authkey_type=0 )
## 1. 接口描述
接口请求域名： static.proxy.qg.net。
本接口 (/get) 用于静态代理产品提取IP资源的接口。
默认接口请求频率限制：（通道数*5+10）次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------- | ------------------------------------------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| area | 否 | String | 按地区提取。 |
| isp | 否 | Integer | 按运营商提取。
0: 不筛选
1: 电信
2: 移动
3: 联通 |
| num | 否 | Integer | 提取个数，默认为1。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ------------ | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data.task_id | String | 提取批次的ID。 |
| data.ips | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| data.num | Integer | 提取到的IP资源数量。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://static.proxy.qg.net/get?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"task_id": "0LIKQ3S1_task",
"ips": [
{
"proxy_ip": "123.54.55.24",
"server": "123.54.55.24:59419",
"area": "河南省商丘市",
"isp": "电信",
"deadline": "2023-02-25 15:38:36"
}
],
"num": 1
},
"request_id": "83158ebe-be6c-40f7-a158-688741083edc"
}
```
## 5. 错误码
| 错误码 | 描述 |
| ---------------------- | ------------------------------------------------------------ |
| INTERNAL_ERROR | 系统内部异常。 |
| INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 |
| INVALID_KEY | Key不存在或已过期。 |
| UNAVAILABLE_KEY | Key不可用，已过期或被封禁 |
| ACCESS_DENY | Key没有此接口的权限。 |
| API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net/user/proxyIpManage)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
| NO_RESOURCE_FOUND | 资源不足。 |
| FAILED_OPERATION | 提取失败。 |
Sstap是一款代理客户端软件。本文将针对代理客户端SSTap使用教程进行详细的说明，具体步骤如下： 软件下载地址：https://github.com/solikethis/SSTap-backup ，下载后解压文件；  第一次打开软件，提示如图信息，点击【安装】；  点击【添加HTTP/SOCK4/SOCK5代理】；  设置代理类型，输入连接信息，点击【保存】即可；  点击【模式】，选择所需的模式，示例中选择【仅网页浏览器（全局）】，然后点击【连接】；  连接成功后提示--已连接！ 
欢迎您使用青果网络服务！
本协议是青果网络与您，就您使用青果网络服务的相关事项签订的合同。为使用青果网络服务，您应当充分阅读、理解本协议，其中限制、免责条款或者其他涉及您重大权益的条款（如违约处罚、争议管辖等）可能会以加粗、加下划线等形式提示您重点注意。
除非您已充分阅读、理解并同意接受和遵守本协议，否则，请您不要使用青果网络服务。您通过网页确认或以其他任何方式明示或者默示表示接受本协议，或您以任何方式使用青果网络服务的，即视为您已阅读并同意接受本协议的约束，本协议即在您与青果网络之间产生法律效力。
使用青果网络服务应当遵守本协议及其服务条款。服务条款以青果网络官网或其他相关页面展示的内容为准，您应事先了解服务条款，并根据服务条款进行操作，以确保顺利使用。
1.1 青果网络服务指青果网络提供的云计算或相关的各种产品、服务（具体以青果网络实际提供的为准），您可以根据自己的需求选择使用一项或多项具体服务并遵守其服务条款。
1.2 涉及具体服务的服务内容、服务等级、技术规范、操作文档、计费标准等内容的服务条款、规则、说明、标准等（统称为“服务条款”），以青果网络官网或其他相关页面展示的内容为准。
1.3 青果网络是中立的技术服务提供者，依约向您提供各类技术产品和服务；您的网站、应用、软件、平台等任何产品、服务及相关内容等，由您自行运营并承担全部责任。
1.4 双方均保证已经依照国家相关规定获得了合法经营资质或政府审批等，有权依法运营其产品及服务。双方进一步保证，在本协议有效期内持续保持具备国家相关规定要求的经营资质或审批手续。
2.1.1 您可根据自身需求，自行通过青果网络官网在线选购所需服务，购买前您需仔细阅读所购服务对应的服务条款并根据自身需求决定是否购买或使用。双方也可根据实际合作需要，另行签订协议等。
2.1.2 部分青果网络服务的开通可能需要双方另行签订单独的服务协议，单独的服务协议可能以电子文档形式展示，也可能是独立的纸质文档形式展示，您可以根据自身情况决定是否接受服务协议及开通服务。
2.1.3 您需在订单提交后及时完成支付。部分服务可能有时间限制、库存限制或者活动数量等限制，订单提交后，若发生您未及时付款、或付款期间出现数量不足或已达到限量等情况的，您将可能无法使用相关服务。
2.1.4 青果网络可能因营销活动、产品推广等各种原因，在特定时期内推出“限时免费”、“限时优惠”、“限量优惠”、“充值优惠”以及赠送服务等优惠措施（以下统称“优惠措施”），您理解并同意，这些优惠措施可能是暂时性、阶段性或有数量限制的，也可能仅适用于满足特定条件的客户，您需要按照相应的规则购买、使用相应服务。除非另有书面明确说明，优惠措施不可同时叠加适用。
2.2.1 青果网络服务的结算方式为预付费类型，为保证服务及时开通或持续提供，您应当遵守本协议及您使用的服务的服务条款并及时缴纳费用。部分青果网络服务开通后，即使您未新增服务项目或资源，亦未进行新的操作，但由于该部分服务会持续占用资源，因此将持续产生扣费，您应当及时续费或关闭服务。
2.2.2 优惠措施是基于特定条件设置，例如针对特定配置的产品的优惠措施、您需一次性使用特定期限或数量的产品方可享受的优惠措施等（如包年优惠），若您最终未符合特定条件，则无法享受相应的优惠（包括但不限于折扣、代金券赠与、优惠使用其他服务等），双方需按照购买时相应服务的官网原价进行费用结算。
2.2.3 您可以通过账号在线付款或充值续费，也可以通过银行转账方式向青果网络支付费用（为保证服务的持续性，若您选择线下支付费用的，应预留合理时间以便青果网络核实到账情况并完成您账号充值）。
2.2.4 本协议项下的业务发生销售折让、销售退回或其他按照国家规定需要开具红字发票或重新开票的情况，青果网络需按照国家税收规定向您开具红字发票或重新开票，您需按照国家税收规定退回青果网络已开具的发票或向税局递交需青果网络开具红字专用发票的有效证明。双方约定具体按以下政策执行：
（1）如果退票发生在发票开具当月且您尚未进行税务认证抵扣的，您退回发票即可。
（2）如果您已就该发票进行税务认证抵扣，或者退票时间已超过开票日期所在当月的，您应向青果网络提供开具红字发票的必要资料，如《开具红字增值税专用发票信息表》等。
（3）对于青果网络尚未开具发票或已开具发票但尚未交付给您的退款申请，无需您提供发票相关资料。
若无法满足上述条件，则无法办理退款，后果由您自行承担，青果网络不就此承担任何责任。在完成上述退票及开具红字发票流程后，青果网络将在次月内按照您实际消费数额重新开具发票，并将您账号内现金部分剩余款项进行退款。
2.3.1 青果网络向您提供售后服务，协助您解答、处理使用青果网络服务过程中遇到的问题。
2.3.2 青果网络将依照法律法规要求对其系统、设备等采取基础的安全保护措施。若您对安全保护措施的要求高于前述基础的安全保护措施标准的，您有权根据自身需求购买配置更高的安全保护服务或另行配置其他安全防护软件、系统等。
2.3.3 您应自行对您使用的计算机信息系统、设备等采取必要的、有效的安全保护措施，因您未采取前述措施导致权益受损的，由您自行承担责任。
2.3.4 青果网络在服务条款约定内提供可用性保障。如果您对可用性的要求高于服务条款，则需要您主动对自身系统进行高可用性的设置，青果网络可给予必要的协助。
2.4.1 为了向您提供更加完善的服务，青果网络有权定期或不定期地对服务平台或相关设备、系统、软件等进行检修、维护、升级及优化等（统称“常规维护”），如因常规维护造成青果网络服务在合理时间内中断或暂停的，青果网络无需为此向您承担责任。但是，青果网络应当至少提前2小时，就常规维护事宜通知您。若因不可抗力、基础运营商过错等原因导致的非常规维护，青果网络应及时通知您。
2.4.2 为保证服务的安全性和稳定性，青果网络可能进行机房迁移、设备更换等重大调整，前述情况可能导致青果网络服务在合理时间内中断或暂停，青果网络无需为此向您承担责任，但是，青果网络应提前1天通知您，您应予以配合；如您不配合进行调整，或者青果网络无法与您取得联系，由此产生的后果由您自行承担。
2.4.3 如您购买的具体服务含有存储功能的，在该服务到期或终止后，对于您存储在该服务中的数据等任何信息，青果网络将根据该服务的服务条款为您保留相应期限。您应承担保留期限内产生的费用（若有），并按时结清费用、完成全部数据的迁移。保留期限届满后，您的前述信息将被删除。
2.4.4 青果网络有权根据自身运营安排，随时调整、终止部分或全部服务（包括但不限于对服务进行下线、迭代、整合等）。但是，青果网络应提前至少3天通知您，以便您做好相关数据的转移备份以及业务调整等，以保护您的合法权益。
2.5 基于网络服务的及时性、复杂性、高效性等特性及监管要求、政策调整等原因，您同意青果网络可以不时对本协议以及青果网络的相关服务条款进行调整，并通过网站公告、邮件通知、短信通知、系统消息、站内信等方式中的一种或多种予以公布；若您在调整后继续使用青果网络服务的，表示您已充分阅读、理解并接受修改后的内容，也将遵循修改后的内容。
2.6 若您选择使用中国大陆以外的服务，应当确保您符合中国大陆法律法规、政策等的要求，同时，也应当确保您的资质、能力以及使用行为等均符合当地法律法规、政策等的要求。
3.1 您有权依照本协议约定使用青果网络服务并获得青果网络的技术支持和售后服务。
3.2 您在使用青果网络的服务时须遵守相关法律法规及服务条款，并确保拥有法律法规要求的经营资质和能力，不得实施包括但不限于以下行为，也不得为任何违反法律法规的行为提供便利：
3.2.1 反对宪法所规定的基本原则的。
3.2.2 危害国家安全，泄露国家秘密，颠覆国家政权，破坏国家统一的。
3.2.3 损害国家荣誉和利益的。
3.2.4 煽动民族仇恨、民族歧视，破坏民族团结的。
3.2.5 破坏国家宗教政策，宣扬邪教和封建迷信的。
3.2.6 散布谣言，扰乱社会秩序，破坏社会稳定的。
3.2.7 散布淫秽、色情、赌博、暴力、凶杀、恐怖或教唆犯罪的。
3.2.8 侮辱或诽谤他人，侵害他人合法权益的。
3.2.9 实施任何违背“七条底线”的行为。
3.2.10 含有法律、行政法规禁止的其他内容的。
3.3 您在使用青果网络的服务时须维护互联网秩序和安全，不得侵犯任何主体的合法权益，不得实施包括但不限于以下行为，也不得为其提供便利：
3.3.1 实施欺诈、虚伪不实或误导行为，或实施侵害他人知识产权等任何合法权益的行为，如“私服”、“外挂”等。
3.3.2 发布、传播垃圾邮件（SPAM）或包含危害国家秩序和安全、封建迷信、淫秽、色情、低俗等违法违规信息。
3.3.3 不应大量占用，亦不得导致如程序或进程等大量占用青果网络的服务中计算、存储或者网络资源（比如但不限于互联网挖矿等行为），并给青果网络的服务带来严重的、不合理的负荷，影响青果网络与相联通的网络、设备间正常通畅的联系。
3.3.4 实施任何破坏或试图破坏网络安全的行为，包括但不限于以病毒、木马、恶意代码、钓鱼等方式，对网站、服务器进行恶意扫描、非法侵入系统、非法获取数据等。
3.3.5 实施任何改变或试图改变青果网络服务提供的系统配置或破坏系统安全的行为；利用技术或其他手段破坏、扰乱青果网络服务的运营或他人对青果网络服务的使用；以任何方式干扰或企图干扰青果网络任何产品或任何部分、功能的正常运行，或者制作、发布、传播上述工具、方法等。
3.3.6 因从事包括但不限于“DNS 解析”、“安全服务”、“域名代理”、“反向代理”等任何业务，导致您自己频繁遭受攻击（包括但不限于 DDoS 攻击）且未及时更正行为，或未根据青果网络要求消除影响，从而对青果网络服务平台或他人产生影响的。
3.3.7不利用青果网络的服务提供任何不经网络审查或依靠技术手段成为境内获取境外非法信息的途径。
3.3.8除青果网络明示许可外，不得修改、翻译、改编、出租、转许可、在信息网络上传播或转让青果网络提供的服务。
3.3.9用户在使用青果网络提供的服务过程中，如涉及第三方，相关单位或人员应具备相应资质，包括但不限于经营许可证，并应根据中华人民共和国相关法律法规规定，落实必要的网络安全措施，包括但不限于人员实名制、留存网络日志，否则应承担由此引起的相关责任。
3.3.10 实施其他破坏互联网秩序和安全的行为。
3.4您须依照《网络安全法》、《互联网信息服务管理办法》等法律法规的规定保留相关网络日志记录并且不少于六个月时长，包括发布的信息内容及其时间、IP地址、域名等，国家有关机关依法查询时应配合提供。您自行承担未按规定保留相关记录而引起的全部法律责任。
3.5 您应当按照服务条款及时、足额支付费用。若您未及时、足额支付费用的，青果网络有权拒绝开通服务或无需另行通知而中止、终止服务，同时可以采取以下一项或多项措施：
3.5.1 要求您除应依约支付应付费用外，每逾期一天，还应按所欠费用1‰的标准向青果网络支付违约金，直至缴清全部费用为止。
3.5.2 若您逾期付款超过7天，青果网络有权无需另行通知您即可随时采取包括但不限于提前单方解除协议的措施。
3.5.3 若您逾期付款但您使用了预付费服务或您账号有未消耗的现金余额的，则青果网络有权无需另行通知您，而直接将预付费用和现金余额用于抵扣拖欠款项和违约金。
3.5.4 删除您基于使用青果网络服务而存储或产生的部分或全部信息和数据。
4.1 青果网络应当依照本协议约定向您提供青果网络服务和售后支持。
4.2 青果网络仅对青果网络服务本身提供运营维护，您应当保证自身的网络、设备的安全性、稳定性，如发生以下情况，您应及时解决并避免对青果网络服务产生影响：
4.2.1 您内部网络出现问题，包括但不限于超负荷等。
4.2.2 您自有设备或您使用的第三方设备出现故障。
4.2.3 您自行拆离设备或通过其他方式导致网络中断。
4.2.4 其他您自身原因导致的任何故障、网络中断等。
4.3 若青果网络自行发现或根据相关部门的信息、权利人的投诉等发现您可能存在违反相关法律法规或本协议的行为的，青果网络有权根据一般人的认识自行独立判断，并随时单方采取以下措施中的一种或多种：
4.3.1 要求您立即删除、修改相关内容。
4.3.2 限制、暂停向您提供全部或部分青果网络服务（包括但不限于直接对您的部分服务进行下线并收回相关资源、对您账号采取操作限制/账号冻结等措施）。
4.3.3 终止向您提供青果网络服务，终止协议（包括但不限于直接对您的全部服务进行下线并收回相关资源等）。
4.3.4 青果网络根据本协议终止向您提供服务或终止协议的，您预缴的费用将作为违约金归青果网络所有。
4.3.5 依法追究您的其他责任。
青果网络依据本协议采取相应措施（包括但不限于暂停服务、扣除费用、终止协议等），不视为青果网络违约，若因此给您造成损失（包括但不限于业务暂停、数据清空等）的，均由您自行承担。因您违反本协议约定产生的责任和后果由您自行承担，若给青果网络或第三方造成损失的，您应当予以赔偿。
4.4 为合理保护您、您的用户及权利人等各方的利益，青果网络有权制定专门的举报和投诉处理制度，您应当予以遵守。如果青果网络接到第三方对您的投诉或举报，青果网络有权向第三方披露您相关资料（如您的主体资料及您就投诉或举报提交的反通知书、相关证据等全部资料），要求您与投诉方进行协商（包括但不限于建立包含您、青果网络以及投诉方的三方邮件组，供您、投诉方直接沟通、相互举证等，下同），若您投诉或举报其他青果网络的客户，青果网络也有权向被投诉方披露您相关资料（如您的主体资料及您就投诉或举报提交的通知书、相关证据等全部资料），要求您与被投诉方进行协商，以便及时解决投诉、纠纷，保护各方合法权益，您应当予以配合，否则，可能会影响您继续使用青果网络服务，由此造成您或他方损失的，您自行承担。
4.5 青果网络可将本协议部分或全部权利义务转让予第三方，但青果网络须提前30天书面通知您。为本款生效之需要，双方同意签订所有合理必要的文件及采取合理必要的措施。
5.6 您同意青果网络有权使用您的名称、品牌、商标标识等作为商业案例进行宣传、展示。
5.1 您保证，您存储、上传、下载到青果网络服务中，或者利用青果网络服务以分析、分发等任何方式处理的数据，为您依法收集、获取或产生的数据，您不会也不曾以任何方式侵犯任何个人或实体的合法权利。
5.2 您保证其有权使用青果网络服务对前述数据进行存储、上传、下载、分析和分发等任何处理，且前述处理活动均符合相关法律法规的要求，不存在任何违法、侵权或违反其与第三方的合同约定的情形，不会将数据用于违法违规目的。
5.3 您有权自行使用青果网络服务对数据进行上传、分析、删除、更改等处理（具体以您使用的服务的服务条款为准），就数据的删除、更改等处理，您应谨慎操作并承担因该等操作所产生的后果。
5.4 除因您使用青果网络服务所需及法律法规另有规定外，未经您同意，青果网络不会接触或使用您的数据。
5.5 您应根据自身需求自行对数据进行备份，青果网络仅依据相关法律法规要求或服务条款约定提供数据备份服务，青果网络仅在法定或约定提供的数据备份服务的范围内承担责任。
5.6 因您的数据的产生、收集、处理、使用等任何相关事项存在违反法律法规等情况而造成的全部结果及责任均由您自行承担，并且，青果网络有权随时全部或部分终止向您提供青果网络服务。您因此遭受的一切损失或承担的一切责任和费用，由您自行承担。
6.1 双方各自享有的商标权、著作权或者其他知识产权，均仍归各方单独享有，并不会因为双方签订或者履行本协议而转归对方享有，或者转归双方共同享有。
6.2 任何一方均应尊重相对方、第三方的知识产权，如有任何第三方就一方侵犯其知识产权等合法权益的原因向另一方提起诉讼、主张索赔的，责任方应当独立处理相关纠纷，赔偿另一方的直接经济损失，并使另一方免责。
7.1 双方为了本协议目的，已经或将会提供或透露某些保密信息。其中，披露保密信息的一方为“披露方”，而接受保密信息的一方为“接收方”。
7.2 “保密信息”指由披露方持有的与其业务、经营、技术及权利等事项相关的，非公开的信息、资讯、数据、资料等，包括但不限于营业规划，商务资料，与技术有关之知识及信息、创意、设想、方案，提供的物品或厂商资料，用户信息，人事资料，商业计划，服务价格及折扣，财务状况等。
7.3 接收方从披露方所获悉的信息，如有标明或可合理认知为属于披露方的保密信息的，接收方须对披露方的保密信息保密，未经披露方书面同意，不得以任何方式披露给第三方或用于本协议以外目的。接收方应以对待其自身保密信息相同的注意程度（且不得低于合理审慎义务）对待披露方的保密信息。
7.4 尽管有前述约定，符合下列情形之一的，相关信息不被视为保密信息：
7.4.1 接收方在披露方向其披露之前已经通过合法的渠道或方式持有的信息。
7.4.2 该信息已经属于公知领域，或该信息在非因接收方违反本协议的情况下而被公开。
7.4.3 接收方合法自其他有权披露资料的第三方处知悉且不负有保密义务的信息。
7.4.4 由接收方不使用或不参考任何披露方的保密信息而独立获得或开发的。
7.5 如果接收方基于法律法规或监管机关的要求，需要依法披露披露方的保密信息的，不视为违反本协议，但接收方应当在法律许可的范围内尽快通知披露方，同时，接收方应当努力帮助披露方有效限制该保密信息的披露范围，保护披露方合法权益。
7.6 双方保密义务在本协议有效期限内及期限届满后持续有效，直至相关信息不再具有保密意义。
7.7 一旦发生保密信息泄露事件，双方应合作采取一切合理措施避免或者减轻损害后果的产生；如因接收方违反保密义务给披露方造成损失的，接收方应赔偿因此给披露方造成的直接经济损失。
7.8 青果网络会按照公布的《青果网络隐私声明》的规定保护您的相关信息。
各方承诺遵守所有适用的经济与贸易制裁以及出口管制法律法规，包括所有由联合国安全理事会、中国、美国及任何其他国家所制定并执行的制裁决议、法律与法规以及出口管制法律与法规（在前述文件适用于该方的范围内）（下称“适用出口管制法律”）。您承诺不会将青果网络提供的产品或服务用于适用出口管制法律所禁止的用途。非经相关主管机关许可，您及您授权使用青果网络提供的产品或服务的个人或实体不会通过青果网络提供的产品或服务向所适用出口管制法律所制裁或指定的个人或实体提供受控的技术、软件或服务，或以任何方式使得青果网络违反适用出口管制法律。
9.1 您理解并同意，在使用青果网络服务的过程中可能会遇到以下情况使服务发生中断。出现下述情况时，青果网络应及时与相关单位配合进行修复，但是由此给您造成的损失青果网络将予以免责。
9.1.1 不可抗力，包括但不限于自然灾害、政府行为、法律法规颁布调整、罢工（任一方内部劳资纠纷除外）、动乱等不能预见、不能避免并不能克服的客观情况。
9.1.2 基础运营商原因，包括但不限于电信部门技术调整、电信/电力线路被他人破坏、电信/电力部门对电信网络/电力资源进行安装、改造、维护。
9.1.3 网络安全事故，如计算机病毒、木马或其他恶意程序、黑客攻击的破坏。
9.1.4 您通过非青果网络授权的方式使用青果网络服务，您操作不当或您的电脑软件、系统、硬件和通信线路出现故障。
9.1.5 其他非青果网络过错、青果网络无法控制或合理预见的情形。
9.2 因不可抗力、基础运营商原因、网络安全事故或其他超出当事人可合理掌控范围的事件，造成本协议迟延履行或任何一方违约，双方均无需承担违约责任。但是，受影响一方应尽可能及时通知另一方。如前述事件妨碍协议履行达30天以上的，任一方可提前15天书面通知对方终止协议。因本条款终止协议的，任何一方均无须承担违约责任。
9.3 您理解并同意，青果网络的服务是按照现有技术和条件所能达到的现状提供的。青果网络将尽最大努力确保服务的连贯性和安全性，但青果网络不能保证其所提供的服务毫无瑕疵，因此，即使青果网络提供的服务存在瑕疵，但若上述瑕疵是当时行业技术水平所无法避免的，其将不视为青果网络违约，青果网络也无需承担任何责任，双方应友好协作共同解决问题。
9.4 于任何情形下，任一方均不对另一方之任何间接的、偶然的、特殊的或惩罚性的损害和损失（如利润损失、机会损失、向第三方支付的费用、声誉/商誉损失或损害等）承担责任，无论基于合同、保证、侵权或任何其他责任理论，不论任一方是否知道或应当知道上述损失或损害的可能性。
9.5 于任何情形下，青果网络基于本协议及相关订单和青果网络服务向您所承担的赔偿责任（无论基于合同、侵权或任何其他责任理论）的总额，不超过您就造成您损失的青果网络服务已经向青果网络支付的费用总额；如果造成您损失的相应青果网络服务的服务期限超过12个月的，则青果网络的最大赔偿责任不超过损害发生前12个月，您就造成您损失的青果网络服务已经向青果网络支付的费用总额（为免歧义，本处费用指您就实际使用该服务的时长/数量等而实际已支付的现金，不包括代金券、预付但未实际消耗的费用等）。若本条款与双方其他约定或青果网络服务条款冲突或不一致的，以本条约定为准。
10.1 您应当保证和维持客户资料（包括但不限于电话号码、电子邮箱等联系方式）的有效性，客户资料若存在虚假、无效等任何可能导致您无法及时获悉业务通知、服务提示、客户服务、技术支持、纠纷协调、违规处罚等信息的，由您自行承担相应责任。
10.2 您应当根据青果网络官网公布的青果网络的联系方式向青果网络发送通知，双方另有约定除外。
10.3 青果网络可通过网页公告、系统通知、站内信、电子邮件、手机短信、即时通讯工具、函件等方式中的一种或多种向您发送与青果网络服务有关的业务通知、服务提示、验证消息、营销信息等各种信息（包括但不限于更新后的服务条款、服务升级、机房裁撤、广告等）。前述信息在以下情况下视为已送达：
10.3.1 交专人递送的，在收件人签收时视为已送达。
10.3.2 以网页公告等形式公布的，一经公布即生效（另有说明除外）。
10.3.3 以电子形式（包括系统通知、站内信、电子邮件、手机短信、即时通讯工具等）发送的，在发送成功后视为已送达。
10.3.4 以邮资预付的快递公司递送或以挂号信递送的，以投邮后的第3个自然日视为已送达。
如果送达时间为法定节假日的，则以送达后首个工作日为送达日。
11.1 本协议的签订地为福建省泉州市丰泽区。
11.2 本协议的成立、生效、履行、解释及纠纷解决等，均适用中国大陆法律法规（不包括冲突法）。
11.3 因本协议产生之争议，双方应首先协商解决；双方未能协商解决的，任何一方均应将争议提交本协议签订地有管辖权的人民法院裁决。双方无争议的部分，应当继续履行。
12.1 除非另有说明，本协议正文及其附件中所有的“天”均为自然日，结算货币均为人民币。
12.2 本协议的拟定、解释均以中文为准。除双方另有约定外，任何有关本协议的翻译不得作为解释本协议或判定双方当事人意图之依据。
12.3 服务条款为本协议的重要组成部分，与本协议正文具有同等法律效力，您应当予以遵守。（正文完）
## 1. 接口描述
接口请求域名： exclusive.proxy.qg.net。
本接口 (/replace) 用于独享代理产品释放并重新提取IP资源的接口。
默认接口请求频率限制：60/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。
备注：调用此接口后，之前提取的资源都会被释放掉！
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| ---------- | ---- | ------- | ------------------------------------------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| area | 否 | String | 按地区提取。支持多地区筛选，逗号隔开。比如："350500,330700"。 |
| isp | 否 | Integer | 按运营商提取。
0: 不筛选
1: 电信
2: 移动
3: 联通 |
| keep_avlie | 否 | Integer | 资源存活时间，单位分钟。 |
| num | 否 | Integer | 提取个数，默认为1。 |
| distinct | 否 | Bool | 去重提取，默认为false。如果为true则不会提取到已经在使用的IP资源。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ------------ | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data.task_id | String | 提取批次的ID。 |
| data.ips | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| data.num | Integer | 提取到的IP资源数量。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://exclusive.proxy.qg.net/replace?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"task_id": "0LIKQ3S1_task",
"ips": [
{
"proxy_ip": "123.54.55.24",
"server": "123.54.55.24:59419",
"area": "河南省商丘市",
"isp": "电信",
"deadline": "2023-02-25 15:38:36"
}
],
"num": 1
},
"request_id": "83158ebe-be6c-40f7-a158-688741083edc"
}
```
## 5. 错误码
| 错误码 | 描述 |
| ---------------------- | -------------------------------------------------------- |
| INTERNAL_ERROR | 系统内部异常。 |
| INVALID_PARAMETER | 参数错误（包含参数格式、类型等错误）。 |
| INVALID_KEY | Key不存在或已过期。 |
| UNAVAILABLE_KEY | Key不可用，已过期或被封禁 |
| ACCESS_DENY | Key没有此接口的权限。 |
| API_AUTH_DENY | Api授权不通过，请检查[Api鉴权配置](https://www.qg.net)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
| DELETE_LIMIT_EXCEEDED | 释放频率超出限制。 |
| NO_RESOURCE_FOUND | 资源不足。 |
| FAILED_OPERATION | 提取失败。 |
