文档中心

## 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数有限。 假设选择的套餐是每分钟10个IP，IP存活时长为2分钟，每分钟都把10个IP提取出来的话，那么第一分钟有10个IP可用，第二分钟也有10+10个IP可用，第三分钟时第一分钟提取的IP失效，仍有20个IP可用，以此类推。 均匀提取的单次提取的上限是100个IP。 **注：**均匀提取所指的“每分钟提取”指的是自然分钟。 IP的存活周期是从提取到IP的那一刻开始算起的，超过这个时长IP会自动失效释放。  ## 二、计费方式： 按每分钟提取的IP数计费，每分钟IP数量的可选区间是2-2000个。 具体的产品套餐价格，还与选择的资源池、购买时长、IP存活时长相关，请以购买页为准。 ## 三、适用场景： 1. 每小时都需要使用IP的客户 2. 每天24小时不间断运行的程序 [开始选用【均匀提取】套餐＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=1&extract_mode=3)

## 一、提取方式介绍： 选择弹性提取方式，意味着用户在业务有效期内，每天可以提取的IP总数是固定的，但时间段不固定。 用户可以自主安排在哪个时段提取使用IP，是集中短时间内提取完，或者分多次提取都可以（单次提取的上限是100个IP）。直到当天的量提取完后，就不能继续提取。等到第二天0点，就会恢复新一天的可提取IP额度。 **注：**IP的存活周期是从提取到IP的那一刻开始算起的，超过这个时长IP会自动失效释放。  ## 二、计费方式： 按每天提取的IP数计费，每天IP量可选区间为100-2000000个。 具体的产品套餐价格，还与选择的资源池、购买时长、IP存活时长相关，请以购买页为准。 ## 三、适用场景： 1. 在每天某个时间段集中使用IP的场景 2. 每天不定期、不规律使用IP的场景 [开始选用【弹性提取】套餐＞](https://www.qg.net/business/proxyip.html?region=domestic&product_type=1&extract_mode=4)

## 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)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |

## 计费模式 代理IP产品主要计费方式为按时购买和按量购买，针对不同的代理IP产品，具有不同的计费方式，代理IP计费说明具体如下：  ### 1.1 按时计费 按时付费是一种先付费后使用的计费方式。通过包年包月，您可以提前预留资源，同时购买的时长越长，享受更大的价格优惠； 1年以上时长的按时产品都有8.33折，帮您更大程度节省支出，如购买12个月，实际支付10个月的费用，购买36个月，实际支付30个月的费用。 所有的按时计费产品都支持免费试用6小时，通道数最大支持5，即同时可免费使用IP最大为5，方便业务测试，保证您能购买到满意的产品。 按时购买方式适用于每天持续运行的客户，更多业务场景需求可联系我们的客户经理咨询~ ### 1.2 按量计费 按量付费是一种先使用后付费的计费方式。通过按量付费，您可以按需购买IP数，IP提取未使用不计费，使用更灵活； 按量IP数的有效期统一为2年，有效期内IP数使用完，可通过【复购】生成同样资源配置的按量IP业务，便捷操作； 按量付费适合短时间需要大量优质IP的客户，也适合希望每天低成本使用少量IP的客户，使用灵活。 ## 续费与升级 ### 2.1 续费 ** 2.1.1 到期后业务状态变化** (1) 到期后，业务进入已过期状态，此时您可以续费业务，续费成功后保留所有代理资源和业务数据； (2) 包周到期后4小时之内，包年包月到期后5天之内，业务会从已过期状态进入业务保留回收中状态，此时您可以续费业务，如果续费失败，请稍后重试或联系客户经理解决；同时业务保留期间如果续费过期后未使用的天数也计算时间。 (3) 删除保留期到期后，未进行续费，所有代理资源和业务数据删除。 **2.1.2 续费** 续费功能仅适用于按时付费代理产品，按量付费代理产品不需要续费。 按时业务到期后会影响业务的正常运行。如果您想继续使用该代理业务，需要在指定时间内为业务续费，否则业务到期且数据保留到期后，业务会自动删除，将无法进行续费； 按时业务即将到期我们会进行提醒，需要续费的用户可及时续费，确保不影响业务的使用； 按量业务到期后或IP量使用完无法进行续费，需要买相同产品配置的代理按量产品直接【复购】即可，详情如下图：  ### 2.2 升级 目前仅按时业务支持业务升级，主要是针对购买的通道数/请求数进行升级，升级价格计算公式：(升级配置价格[月] - 原始配置价格[月]) * 12 / 365 * 到期剩余天数，使用的过程中需要升级通道数/请求数，可至会员中心--代理IP--按时业务操作“升级”，具体位置如下图： 

## 计费概述 青果代理IP产品购买方式：按时购买、按量购买，分别适用于不同场景下的用户需求。 ## 1 计费项及计费方式  *为保证获取到的价格的准确性，请您登录后查看。 ## 2 计费示例 产品：隧道代理（动态请求），10请求数/秒，时长6个月； 基础配置费用：360，隧道共享（动态请求），默认1个月，5请求/秒； 10请求数费用：（请求数-默认请求数）*请求数单价，60元/请求数，（10-5）×60=300； 总配置费用：基础价格*时长+请求数费用，360×6+300=3960元。 ## 3.续费说明 按时计费业务到期后将不可使用。如果您想继续使用代理IP资源，需要在指定时间内为业务续费，否则IP资源将不可用； 按量计费业务到期或用完之后无法续费，选择【复购】，会生成相同配置的业务； ## 4.支付与退款 购买代理IP产品，您可以选择以下支付方式： - 青果账户余额； - 在线支付，支持微信支付、支付宝，不能使用信用卡支付。