## 一、提取方式介绍： 选择按量提取方式，即选择业务有效期内可用的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)

## 一、提取方式介绍： 选择均匀提取方式，则用户每分钟能提取到的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)

**简要描述：** - 获取按量产品列表信息 **输入示例：** - https://qg.net/api/Proxyip/resourceSpecList **返回示例** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "1":{ "Id": 62, "Spec_name": "短效代理1-5分钟", "Spec_no": "dtgx001", "Ip_nums": 10000, "Price": "30.00", "Months": 24, "Show_status": 1, "Buy_status": 1, "Group_type_id": 2, "Desc": "IP数量 : 同时可使用的IP数等于购买的通道数 \r\nIP存活时长 : IP长久有效\r\nIP可用率 : 99.9%\r\nIP重复率 : <1%\r\nIP分布地区 : 全国主要省份\r\n终端数限制 : 不限制\r\n带宽峰值限制 : 2Mbps\r\n地区筛选 : 支持指定获取某个城市IP或全国随机\r\n代理类型 : HTTP、HTTPS、SOCKS5\r\n", "Brand_name": "青果云", "Create_time": 1615887813, "Update_time": null, "Connect" : "33" } }， "Message":"获取成功" } ``` **返回参数说明** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Id |integer |ID | |Spec_name |string |产品名称 | |Ip_nums |integer |IP数量 单位万个| |Price |float |价格 | |Months |integer |有效期 | |Show_status |integer |状态 1:显示 0：不显示 | |Buy_status |integer |状态 1:禁用 0：禁用 | |Desc |string |基本介绍| |Group_type_id |integer |规格ID| |Brand_name |string |品牌名称| |Connect |string |连接数| |Connect_limit |string |连接数限制| **备注** - 更多返回错误代码请看首页的错误代码描述