长效代理-产品介绍
## 1 产品简介
长效代理是以高性能云主机为主，一手散段IP资源为辅建设的高品质代理服务器，青果除了为客户提供可以长期持有的静态IP之外，还有多种存活时长(1天以上)、可动态切换的长效IP资源。
【静态类型】：普惠版与高级版，普惠版的IP是长期不变的，独享带宽高稳定性。而高级版特别提供了自主更换IP的功能，一周可自主更换**2**次。
【动态类型】：IP存活时长为数小时到数天范围内自然失效，有低带宽和高带宽套餐可选。API提取模式下，需手动提取IP；也可选择打开隧道转发功能，那么IP失效之后将自动连接新IP。
长效代理使用非常方便，只需几分钟，您就可以通过[API链接](https://www.qg.net/tools/IPget.html?type=1-1)获取代理IP并参照[代码样例](https://www.qg.net/list/192.html)集成到您的程序中。
## 2 产品优势
- IP时长可控，自主释放，可用时长从24小时到365天全覆盖，满足多场景需求；
- 真实IP地址，IP稳定性强；
- 提供丰富的API接口，调用方便快捷。
- IP真实，全年7x24小时稳定可用
- 静态类型独享带宽和IP，稳定性强
- 极速（访问百度测试，响应时间<1秒）
- 支持指定获取某个城市IP或全国随机
## 3 适合人群
适用于需要业务环境隔离或长期固定IP的业务场景。
## 4 付费模式
静态产品提供普通版和高级版两种套餐，对应不同价格
- 普惠版产品IP长期不变，
- 高级版可根据需求，一周内可自主更换两次。
皆为按时计费 模式，可按周、按月、按年付费。
动态产品提供不同带宽的两个套餐，对应不同价格。
## 5 产品属性
- 免费白名单数量：256
- 支持协议：HTTP/HTTPS/SOCKS5
- 单IP最大连接数：1000
- 单IP带宽限制：静态普惠版1Mbps，静态高级版2Mbps。动态有2M和5M选择。
- 终端数限制：无限制
- 提取资源频率： (通道数*5+10 ) 次/分钟
- 单次提取IP上限：100个
## 6 用途
**长效代理可用于：**
- 跨境电商店铺运营
- 观看视频
- 舆情监测
- 广告检测
- 直播/短视频数据监控分析
**不适用于以下场景**
- 访问谷歌等国内正常无法访问的网站；
- 大文档、音乐、视频等大文件下载；
- 登录和访问色情、赌博等不健康的网站；
- 用于网络攻击等违法行为。
## 7 使用指南
长效代理使用非常方便，您可以选择①**手动设置**代理IP并在浏览器中使用，
也可以通过②**API接口获取**代理并参照代码样例集成到您的程序中。
具体请查看
- [手动设置代理指南 ＞](https://www.qg.net/doc/product/6_258_281/2268.html)
- [开发者使用代理指南 ＞](https://www.qg.net/doc/product/6_258_281/1795.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 )
全球-长效代理-API接口介绍
## 1 说明
通过编码使用长效代理（全球HTTP）-通道提取主要有以下4步骤：
1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口；
2.使用白名单或账密进行授权验证；
3.进行代理测试；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤")
4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序，使用代理IP。
## 2 API接口
长效代理（全球HTTP）-通道提取API接口一览
| 接口类型 | API | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [get](https://www.qg.net/doc/6637.html)
- [query](https://www.qg.net/doc/6638.html)
- [channels](https://www.qg.net/doc/6639.html)
| - 提取IP资源
- 查询在用IP资源
- 查询通道数
|
| 白名单相关 | - [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 "删除白名单")
| - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |
全球-长效代理-查询通道数
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/channels) 用于全球-长效代理产品查询通道数的接口。
默认接口请求频率限制：60次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=2-2)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data.toal | Integer | key的通道总数。 |
| data.idle | Integer | 空闲通道数。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://overseas.proxy.qg.net/channels?key=<您的key信息>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"total": 10,
"idle": 5
},
"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 | 请求频率超出限制。 |
全球-长效代理-查询在用IP资源
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/query) 用于全球-长效代理产品查询在用的IP资源的接口。
默认接口请求频率限制：60次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=5-2)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://overseas.proxy.qg.net/query?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": [{
"proxy_ip": "129.150.42.240",
"server": "129.150.42.240:18080",
"area": "新加坡",
"deadline": "2023-02-25 15:38:36"
}],
"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 | 请求频率超出限制。 |
全球-长效代理-提取IP资源
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/get) 用于全球-长效代理产品提取IP的接口。
默认接口请求频率限制：（通道数*5+10）次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=5-2)。
需注意，如使用白名单IP，请在提取前添加白名单。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------- | ------------------------------------------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| area | 否 | String | 国家筛选。支持国家编码和自定义编码，比如：US,EU，或者990100,990200。[国家编码](https://www.qg.net/doc/use/8_234_201/1975.html) |
| area_ex | 否 | String | 排除某些地区提取。使用方式同上 |
| num | 否 | Integer | 提取个数，默认为1 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ----------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of [IP](https://www.qg.net/doc/1839.html) | IP资源列表。
**注：IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://overseas.proxy.qg.net/get?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": [{
"proxy_ip": "129.150.42.240",
"server": "129.150.42.240:18080",
"area": "新加坡",
"deadline": "2023-02-25 15:38:36"
}],
"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/proxyipResource)。 |
| KEY_BLOCK | Key被封禁。 |
| REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
| BALANCE_INSUFFICIENT | Key余额不足。 |
| NO_RESOURCE_FOUND | 资源不足。 |
| FAILED_OPERATION | 提取失败。 |
| EXTRACT_LIMIT_EXCEEDED | 超出提取配额。 |
全球-独享代理（地区锁）-API接口介绍
## 1 说明
通过编码使用全球-独享代理（地区锁独占）主要有以下4步骤：
1.先在[提取工具](https://www.qg.net/tools/IPget.html)或[调试工具](https://www.qg.net/tools/IPdebug.html)上获取api接口；
2.使用白名单或账密进行授权验证；
3.进行代理测试；[查看测试步骤＞＞](https://www.qg.net/doc/1574.html "查看测试步骤")
4.参考[代码样例](https://www.qg.net/list/192.html)编写采集程序，使用代理IP。
## 2 API接口
全球-独享代理（地区锁独占）-按量提取API接口一览
| 接口类型 | API | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [monopolize](https://www.qg.net/doc/6630.html)
- [query_monopolize](https://www.qg.net/doc/6631.html)
- [channels](https://www.qg.net/doc/6632.html)
- [changeip](https://www.qg.net/doc/6633.html)
- [delete_monopolize](https://www.qg.net/doc/6634.html)
| - 提取资源
- 查询在用资源
- 查询通道
- 更换IP
- 释放资源
|
| 白名单相关 | - [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 "删除白名单")
| - 查询IP的白名单
- 添加IP的白名单
- 删除IP的白名单 |
全球-独享代理（地区锁）-释放资源
## 海外独占-释放资源
`https://overseas.proxy.qg.net/delete_monopolize`
### 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| uuid | 是 | String | 释放指定的独占资源。 |
### 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | --------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of String | 释放成功的独占资源UUID列表。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
### 输入示例
```
GET https://overseas.proxy.qg.net/delete_monopolize?key=<您的key信息>&<其他输入参数>
```
### 输出示例
```json
{
"code": "SUCCESS",
"data": [
"jike-hk:ppp497"
],
"request_id": "df747ce4-2e60-4c3d-bade-05535f5dadee"
}
```
全球-独享代理（地区锁）-更换IP
## 海外独占-更换IP
`https://overseas.proxy.qg.net/changeip`
### 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | --------------------------------------------------- |
| key | 是 | String | 公共参数，产品唯一标识。 |
| uuid | 是 | String | 需要更换IP的独占资源uuid。 更换指定的独占资源的IP。 |
### 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | --------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of String | 更换成功的独占资源UUID列表。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
### 输入示例
```
GET https://overseas.proxy.qg.net/changeip?key=<您的key信息>&<其他输入参数>
```
### 输出示例
```json
{
"code": "SUCCESS",
"data": [
"jike-hk:ppp497"
],
"request_id": "61af19f0-e906-4654-9c08-ab86ed0a0ba3"
}
```
---
全球-独享代理（地区锁）-查询通道
## 海外独占-查询通道
`https://overseas.proxy.qg.net/channels`
### 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
### 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ------ | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Object | 通道信息对象，包含 total（通道总数）与 idle（空闲通道数）。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
### 输入示例
```
GET https://overseas.proxy.qg.net/channels?key=<您的key信息>
```
### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"total": 5,
"idle": 4
},
"request_id": "22904b81-1a7e-4402-a981-0955f0ed157d"
}
```
---
##
全球-独享代理（地区锁）-查询在用资源
## 海外独占-查询在用资源
`https://overseas.proxy.qg.net/query_monopolize`
### 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| uuid | 否 | String | 查询指定的独占资源。 |
### 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ----------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data | Array of Monopoly | 在用资源列表。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
### 输入示例
```
GET https://overseas.proxy.qg.net/query_monopolize?key=<您的key信息>&<其他输入参数>
```
### 输出示例
```json
{
"code": "SUCCESS",
"data": [
{
"uuid": "jike-hk:ppp497",
"area": "日本",
"area_code": 992600,
"state": "在线",
"ip": "45.131.177.11:20500",
"real_ip": "106.73.200.32",
"heartbeat": "2026-06-12 15:12:33",
"monopolize_time": "2026-06-12 15:08:31"
}
],
"request_id": "b97aa60a-458c-4c3d-92f1-16762c5226ef"
}
```
---
##
