## 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 | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [get](https://www.qg.net/doc/product/6_258_274/1863.html)
- [delete](https://www.qg.net/doc/product/6_258_274/1862.html)
- [query](https://www.qg.net/doc/product/6_258_274/1861.html)
- [channels](https://www.qg.net/doc/product/6_258_274/1860.html)
- [resources](https://www.qg.net/doc/product/6_258_274/1859.html)
| - 提取IP资源
- 释放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的白名单 |
在Centos7.6中如何设置代理IP呢？本文给出详细说明。 1.vi打开.bashrc文件  2.使在文件末尾添加代理后保存退出 export http_proxy=http://AuthKey:AuthPwd@IP:PORT export https_proxy=http://AuthKey:AuthPwd@IP:PORT  3.重启或者运行source .bashrc即时生效 
## 1. 接口描述 接口请求域名： exclusive.proxy.qg.net。 本接口 (/delete) 用于独享代理产品释放IP资源的接口。 默认接口请求频率限制：<通道数> * 2 / 分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------------------------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | | task | 否 | String | 按提取批次释放。支持批量释放，用逗号隔开。比如：Z5p2DKKCSyhocKEa,xsQGWfoaX99WcYnU。 | | ip | 否 | String | 按IP释放。支持批量释放，用逗号隔开。比如：129.123.7.89,23.11.112.51。 | **注意： 1、task和ip必选其一，如果两个参数都填写，以task为准。 2、如果需要释放全部IP，用task="\*"或者ip="\*"即可。 3、这里的释放参数ip为提取接口返回的proxy_ip值** ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------ | ------------------------------------------------------------ | | code | String | 请求状态码。 | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://exclusive.proxy.qg.net/delete?key=<您的key信息>&<其他输入参数> ``` #### 输出示例 ```json { "code": "SUCCESS", "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 | 请求频率超出限制。 | | DELETE_LIMIT_EXCEEDED | 释放频率超出限制。 |
## 1. 接口描述
接口请求域名： share.proxy.qg.net。
本接口 (/query) 用于短效代理产品通道提取模式下查询IP的接口。
默认接口请求频率限制：60次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。
## 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://share.proxy.qg.net/query?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": [
{
"proxy_ip": "123.54.55.24",
"server": "123.54.55.24:59419",
"area": "河南省商丘市",
"isp": "电信",
"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 | 请求频率超出限制。 |
**简要描述：**
API支持基于URL发起HTTP/HTTPS GET请求。请求参数需要包含在URL中。本文列举了GET请求中的结构解释，并提供了服务器的服务接入地址
**通信方式：**
以下为Start一条未编码的URL请求示例：
https://www.qg.net/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 | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [get](https://www.qg.net/doc/product/6_255_263_265/1851.html)
- [balance](https://www.qg.net/doc/product/6_255_263_265/1852.html)
- [resources](https://www.qg.net/doc/product/6_255_263_265/1853.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的白名单 |
**提示：**短效代理根据提取方式的不同，提供了不同的API接口，本文介绍的是按量提取业务相关接口。
请点击文字查看其他产品接口：
[弹性提取 ＞](https://www.qg.net/doc/product/6_255_263_264/2254.html)
[均匀提取 ＞](https://www.qg.net/doc/product/6_255_263_266/2258.html)
[通道提取 ＞](https://www.qg.net/doc/product/6_255_263_267/2139.html)
## Response
请求响应详情
被所有接口引用。
| 名称 | 类型 | 描述 |
| ---------- | ------ | ------------------------------------------------------------ |
| code | String | 响应[状态码](https://www.qg.net/doc/1838.html)。 |
| data | Any | 请求响应数据。 |
| message | String | 报错信息。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## IP
代理IP详情
被如下接口引用：[短效代理提取](https://www.qg.net/doc/1846.html), [短效代理查询](https://www.qg.net/doc/1847.html), [短效代理资源池](https://www.qg.net/doc/1850.html), [独享代理提取](https://www.qg.net/doc/1840.html), [独享代理查询](https://www.qg.net/doc/1841.html), [独享代理更换](https://www.qg.net/doc/1843.html), [静态代理提取](https://www.qg.net/doc/1863.html), [静态代理查询](https://www.qg.net/doc/1861.html)。
| 名称 | 类型 | 描述 |
| -------- | ------ | ------------------------------------------------------------ |
| proxy_ip | String | 代理真实出口IP地址，比如: 120.11.67.89。 |
| server | String | 代理服务地址，挂代理直接使用这个字段信息，比如：120.11.67.89:8090。 |
| area | String | 代理IP地区信息。 |
| isp | String | 代理IP运营商信息。 |
| deadline | String | 动态代理表示代理IP的存活截至时间；
静态代理表示代理IP的可释放时间。 |
## Task
单次提取详情
被如下接口引用：[短效代理提取](https://www.qg.net/doc/1846.html), [短效代理查询](https://www.qg.net/doc/1847.html), [短效代理资源池](https://www.qg.net/doc/1850.html), [独享代理提取](https://www.qg.net/doc/1840.html), [独享代理查询](https://www.qg.net/doc/1841.html), [独享代理更换](https://www.qg.net/doc/1843.html), [静态代理提取](https://www.qg.net/doc/1863.html), [静态代理查询](https://www.qg.net/doc/1861.html)。
| 名称 | 类型 | 描述 |
| ------- | --------------- | ---------------- |
| task_id | String | 本次提取的标识。 |
| ips | Array of [IP]() | IP资源信息。 |
| num | Integer | IP资源总数。 |
## Balance
余额详情
被如下接口引用：[短效代理余额查询](https://www.qg.net/doc/2256.html)。
| 名称 | 类型 | 描述 |
| ------- | ------- | -------------- |
| balance | Integer | 剩余资源总数。 |
## Channel
通道数详情
被如下接口引用：[短效代理通道数查询](https://www.qg.net/doc/1849.html), [独享代理通道数查询](https://www.qg.net/doc/1844.html), [静态代理通道数查询](https://www.qg.net/doc/1860.html)。
| 名称 | 类型 | 描述 |
| ----- | ------- | ------------ |
| total | Integer | 总通道数。 |
| idle | Integer | 空闲通道数。 |
## ResourceAreaISP
资源可用地区和运营商详情
被如下接口引用：[短效代理资源地区查询](https://www.qg.net/doc/2257.html), [独享代理资源地区查询](https://www.qg.net/doc/1845.html), [静态代理资源地区查询](https://www.qg.net/doc/1859.html)。
| 名称 | 类型 | 描述 |
| --------- | ------- | ---------------- |
| area | String | 地区信息。 |
| area_code | Integer | 地区码。 |
| isp | String | 运营商信息。 |
| isp_code | Integer | 运营商编码。 |
| available | Bool | 是否有可用资源。 |
## Monopoly
独占资源详情
被如下接口引用：[独享代理提取](https://www.qg.net/doc/1840.html), [独享代理查询](https://www.qg.net/doc/1841.html)。
| 名称 | 类型 | 描述 |
| --------------- | ------ | ------------------------------------ |
| uuid | String | 资源唯一标识。 |
| area | String | 地区信息。 |
| isp | String | 运营商信息。 |
| state | String | 资源状态。 |
| ip | String | 最新IP，仅当state="在线"有值。 |
| heartbeat | String | 最后一次心跳，仅当state="在线"有值。 |
| monopolize_time | String | 独占的时间。 |
| last_dial_time | String | 最后一次切换的时间。 |
## ResourceAreaISPWithIdle
地区和运营商可用独占资源统计
被如下接口引用：[独享代理资源地区查询](https://www.qg.net/doc/1845.html)。
| 名称 | 类型 | 描述 |
| --------- | ------- | ------------ |
| area | String | 地区信息。 |
| area_code | Integer | 地区码。 |
| isp | String | 运营商信息。 |
| isp_code | Integer | 运营商编码。 |
| idle | Integer | 空闲资源数。 |
## 1. 接口描述
接口请求域名： exclusive.proxy.qg.net。
本接口 (/query) 用于独享代理产品查询在用的IP资源的接口。
默认接口请求频率限制：60次/分钟。
推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html)。
## 2. 输入参数
| 参数名称 | 必选 | 类型 | 描述 |
| -------- | ---- | ------ | ------------------------------------------------------------ |
| key | 是 | String | 公共参数，产品唯一标识。 |
| task | 否 | String | 提取批次筛选。支持多批次筛选，用逗号隔开。比如："Z5p2DKKCSyhocKEa,kAEaWHucf8iPXm0O"。 |
## 3. 输出参数
| 参数名称 | 类型 | 描述 |
| ---------- | ------------------------------------------------- | ------------------------------------------------------------ |
| code | String | 请求状态码。 |
| data.tasks | Array of [Task](https://www.qg.net/doc/1839.html) | 提取批次列表。
**注：Task结构中的IP结构中的server才是代理地址，proxy_ip是代理的真实出口IP。** |
| data.num | Integer | 提取批次数量。 |
| request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 |
## 4. 示例
#### 输入示例
```
GET https://exclusive.proxy.qg.net/query?key=<您的key信息>&<其他输入参数>
```
#### 输出示例
```json
{
"code": "SUCCESS",
"data": {
"tasks": {
"task_id": "Z5p2DKKCSyhocKEa",
"ips": [
{
"proxy_ip": "123.54.55.24",
"server": "123.54.55.24:59419",
"area": "河南省商丘市",
"isp": "电信",
"deadline": "2023-02-25 15:38:36"
}
],
"num": 1
},
"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 | 请求频率超出限制。 |
## 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 | 描述 |
| ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ |
| 资源相关 | - [get](https://www.qg.net/doc/product/6_255_263_264/2255.html)
- [balance](https://www.qg.net/doc/product/6_255_263_264/2256.html)
- [resources](https://www.qg.net/doc/product/6_255_263_264/2257.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的白名单 |
**提示：**短效代理根据提取方式的不同，提供了不同的API接口，本文介绍的是弹性提取业务相关接口。
请点击文字查看其他产品接口：
[均匀提取 ＞](https://www.qg.net/doc/product/6_255_263_266/2258.html)
[通道提取 ＞](https://www.qg.net/doc/product/6_255_263_267/2139.html)
[按量提取 ＞](https://www.qg.net/doc/product/6_255_263_265/2140.html)
## 计费模式 代理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--按时业务操作“升级”，具体位置如下图： 
