## 1 概述 为了保证您购买的代理业务只有您的服务器才能使用，我们采用了IP白名单验证方式，通过设置IP白名单IP，除了您指定的服务器IP外，其他IP不能使用。 白名单可以免密钥验证，免费IP白名单鉴权数量高达256个，也就是说购买后您有256台独立外网IP的机器可以使用。不限制同时使用的终端设备数量，满足多业务需求。 需要注意的是，要在未提取IP之前添加白名单；短效代理产品不同key不能添加相同的白名单IP。 ## 2 步骤说明 ### 2.1 先查到您要使用的机器的外网IP。 如果是办公室电脑，可以访问https://ip.cn/api/index?ip=&type=0 查询您的外网IP； 如果是Linux服务器，可以通过如下命令查看机器外网IP：`curl https://d.qg.net/ip` ### 2.2 绑定您机器的IP作为白名单 根据您购买的代理业务，您可以在【会员中心-列表操作-白名单】或调试工具添加IP白名单，完成设置后，这些IP对应的机器就可以正常使用了。 **2.2.1 白名单管理** 进入会员中心，找到您所在的业务，点击右侧【更多】下的【业务设置】-【白名单管理】，进入设置；  你可以在该页面添加、删除白名单，详情如下图：  ** 2.2.2 调试工具** 在调试工具上勾选要使用的业务key，选择【IP白名单】模块相关操作接口，包括添加、删除和查询，输入您的机器外网IP，点击测试即可完成设置。详情如下图：   ### 2.3 API调用 白名单的设置也支持编程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＞")

为助力高校科研与教育，青果面向广大高校学生用户推出了[【青果高校计划】＞](https://www.qg.net/activity/3)， 活动涵盖代理IP的短效代理与隧道代理产品，**学生专享6.8折优惠！** 助力高校学生更轻松地进行学术实践与创新，真实受益于普惠算力。 **以下介绍进行学生认证的步骤** ## 1.完成个人认证 在青果，进行学生认证之前，需要完成个人认证。您可以在控制台选择支付宝/微信方式进行实名认证。  ## 2.开始学生认证 完成个人实名认证之后，将在认证页面看到【前往学生认证】的入口，点击进入。  **完成学生认证共有3步，下面根据步骤提醒开始认证**  ## 3.登录学信网 [点击登录学信网](https://account.chsi.com.cn/passport/login "点击登录学信网")  ## 4.查看教育部在线验证报告 进入学信档案-在线验证报告。  查看“教育部在线验证报告”  生成在线验证报告。  查看已申请的报告。  ## 5.提交验证报告url 将在学信网查询道德学籍在线验证报告url提交至系统。   ## 6.完成认证 完成学生认证之后，就能以学生身份享受相关政策与优惠了。

选择按量提取方式，即选择业务有效期内可用的流量包大小，可自由决定何时使用。不限制提取使用的IP个数，仅限制所能使用的流量总量。 提取IP并开始使用后，将会损耗对应的流量，当流量包扣取完后套餐将失效，需要续费或重新购买。用户可以根据业务使用情况，来预测选择合适大小的流量包套餐。 **请注意：**按量提取模式中，单次提取的上限是200个IP。且提取IP是免费的，真实使用IP才会扣取流量。 **注：**IP的存活周期是从提取到IP的那一刻开始算起的，超过这个时长IP会自动失效释放。  #### 二、计费方式： 按使用的流量计费，可选择的流量套餐有1/10/100/500/1000/3000G流量包。 具体的产品套餐价格，还与选择购买时长、IP存活时长相关，请以购买页为准。 #### 三、适用场景： 1. 短时间内集中大量使用IP的场景 2. 流量使用量不固定的场景 [开始选用【按量提取】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&extract_mode=2)

## 一、提取方式介绍： 选择按量提取方式，即选择业务有效期内可用的IP总数，可以灵活控制什么时候提取和使用。 以购买10000个IP，有效期45天为例，用户可以在有效期内的任意时间提取这10000个IP进行使用，提取IP会扣减相应的数量，直到IP余数为0时将不能再提取IP，需要续费或重新购买。 按量提取的单次提取的上限是200个IP。 **注：**IP的存活周期是从提取到IP的那一刻开始算起的，超过这个时长IP会自动失效释放。  ## 二、计费方式： 按提取的IP数计费，IP数量的可选区间是1W-50W个（15-30分钟存活时长的IP数可选区间位1-20W）。 具体的产品套餐价格，还与选择的资源池、购买时长、IP存活时长相关，请以购买页为准。 ## 三、适用场景： 1. 短时间内集中大量使用IP的场景 2. 不定期、不规律使用IP的场景 [开始选用【按量提取】套餐＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=1&extract_mode=2)

## 1. 接口描述 接口请求域名： share.proxy.qg.net。 本接口 (/balance) 用于短效代理产品按量提取模式下查询余额的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ------------ | ------- | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data.balance | Integer | key的IP余额。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://share.proxy.qg.net/balance?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": { "balance": 9999 }, "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 | 请求频率超出限制。 |

## 1. 接口描述 接口请求域名： share.proxy.qg.net。 本接口 (/resources) 用于短效代理产品弹性提取模式下查询资源地区的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data | Array of [ResourceAreaISP](https://www.qg.net/doc/1839.html) | 资源地区列表。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://share.proxy.qg.net/resources?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": [ { "area": "福建省泉州市", "area_code": 350500, "isp": "电信", "isp_code": 1, "available": false }, { "area": "河南省商丘市", "area_code": 411400, "isp": "电信", "isp_code": 1, "available": true } ],     "request_id": "51024a8b-a8a5-4e78-9301-cb500a8c083e" } ``` ## 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 | 请求频率超出限制。 |

## 1. 接口描述 接口请求域名： share.proxy.qg.net。 本接口 (/balance) 用于短效代理产品弹性提取模式下查询余额的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ------------ | ------- | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data.balance | Integer | key当天的剩余可提取的数量。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://share.proxy.qg.net/balance?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": { "balance": 9999 }, "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 | 请求频率超出限制。 |

**全球HTTP均不支持在中国大陆地区网络环境下使用**。 #### 一、介绍 青果住宅池IP资源，是由来自全球200+国家地区的大量分散的真实住宅网络汇聚而成，日去重数达2000W+。 住宅IP，是由当地互联网服务提供商（ISP）分配给家庭/企业用户的IP，在IP的所属ASN信息上type类型表现为isp。 住宅池IP的特性表现为具有很高的匿名性，能够模拟真实用户行为场景，满足更高的安全代理要求，业务成功率高。  #### 二、资源池特点 相比于数据中心池，住宅池 - 青果提供的资源数量更多，适合企业级采集项目 - 匿名性相对较高，业务成功率高 - 稳定性相对较弱 #### 三、使用客户群 - 有大量IP使用需求的客户 - 对采集成功率要求高的客户 [开始选用【住宅池】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3&pool_type=12)

选择通道提取方式，意味着业务有效期内可同时在线使用的IP数是固定的，但不限制流量使用。 每个通道在某个时刻可以使用一个IP。当这个IP的存活时长结束之后，通道可以提取一个新的IP来替代。如果你购买了多个通道，你可以在任何一个IP到期后重新提取新的IP，直到你正在使用的IP数量与你购买的通道数量相匹配为止。 通道提取提供多种的IP存活周期可选，可以选择短时间的5分钟/15分钟/30分钟/1小时，也可以选择长时的24小时/720小时，最长可以保持30天。 **注：**IP的存活周期是从提取到IP的那一刻开始算起的，超过这个时长IP会自动失效释放。  #### 二、计费方式： 按同时在线的IP数（即通道数）计费，通道数的可选区间是1-1000个。 具体的产品套餐价格，还与购买时长、IP存活时长相关，请以购买页为准。 #### 三、适用场景： 1. 流量使用较大的场景 2. 每天业务不间断的场景 [开始选用【通道提取】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=1&extract_mode=1)

## 一、提取方式介绍： 选择通道提取方式，意味着业务有效期内可同时在线使用的IP数是固定的。 每个通道在某个时刻可以使用一个IP。当这个IP的存活时长结束之后，通道可以提取一个新的IP来替代。如果你购买了多个通道，你可以在任何一个IP到期后重新提取新的IP，直到你正在使用的IP数量与你购买的通道数量相匹配为止。 通道提取提供较多的IP存活周期可选，包含1分钟/2分钟/3分钟/5分钟/1-5分钟/5-15分钟/15-30分钟，7种时长规格可选。 **注：**IP的存活周期是从提取到IP的那一刻开始算起的，超过这个时长IP会自动失效释放。  ## 二、计费方式： 按同时在线的IP数（即通道数）计费，通道数的可选区间是1-1000个。 具体的产品套餐价格，还与选择的资源池、购买时长、IP存活时长相关，请以购买页为准。 ## 三、适用场景： 1. IP使用量固定的业务场景 2. 每天业务不间断的场景 [开始选用【通道提取】套餐＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=1&extract_mode=1)