**简要描述：** - 获取已购买按量产品列表信息。 **参数：** |参数名|必选|类型|说明| |:----- |:-----|-----|-----| |resource_no|否|string|按量业务标识| |offset|否|int|偏移量，默认为0| |limit|否|int|限制数目，默认值20；最大值50| **输入示例一：** - 查询单业务 - https://qg.net/api/proxyip/resourceView?resource_no=m2BJvcFYQ **返回示例：** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": { "Resource_no":"m2BJvcFYQ", "Authkey": "DOXM4R7T", "Number": 10000, "Buy_time": "2021-04-25 14:46:50", "End_time": "2022-04-25 14:46:50", "Order_status": 1, "Type": 1, "Ip_type": 2, "Resource_available": 10000, "Tunnel_url": "tunnel.qg.net:3434" }， "Message":"获取成功" } ``` **输入示例二：** - 查询多业务 - https://qg.net/api/proxyip/resourceView?offset=0&limit=20 **返回示例：** JSON格式 ``` { "RequestId":"ASDF4ASF-ASDFASF", "Code": 200, "Data": [ { "Resource_no":"m2BJvcFYQ", "Authkey": "DOXM4R7T", "Number": 10000, "Buy_time": "2021-04-25 14:46:50", "End_time": "2022-04-25 14:46:50", "Order_status": 1, "Type": 1, "Ip_type": 2, "Resource_available": 10000, "Tunnel_url": "tunnel.qg.net:3434" }， { "Resource_no":"7cCu0BaZv", "Authkey": "DOXM4R7T", "Number": 10000, "Buy_time": "2021-03-25 14:46:50", "End_time": "2022-03-25 14:46:50", "Order_status": 1, "Type": 1, "Ip_type": 2, "Resource_available": 10000, "Tunnel_url": "tunnel.qg.net:3434" }， ] "Message":"获取成功" } ``` **返回参数说明：** |参数名|类型|说明| |:----- |:-----|----- | |RequestId |string |请求编号 | |Code |integer |返回状态码 | |Message |string |返回内容 | |Resource_no|string|按量业务标识| |Authkey |string |Authkey | |Number |integer |按量业务总量| |Connect |integer |连接数| |Buy_time |string |购买时间| |End_time |string |到期时间| |Order_status |string |状态 1：正常, 3：过期,-4：开通失败; -5：续费失败, -6：升级失败, -7：锁定| |Type |integer |资源类型 1：独享,2：共享| |Ip_type |integer |IP类型 1：静态,2：动态，3：隧道| |Resource_available |integer |按量业务余量| |Tunnel_url |string |隧道地址| **备注：** 更多返回错误代码请看首页的错误代码描述。
## 一、介绍 中转池，由大量的边缘节点汇聚而成，其基于的青果自营高性能代理服务器，通过中转+多线快速转发技术，代理更加高速稳定。 选择中转池的业务，用户提取到的IP将经过一层转发，以另外一个出口IP进行公网访问。出口IP是真实IP，且因为资源来自于大量边缘节点，中转池IP资源丰富且分散，业务成功率高。 中转池拥有400W+纯净IP，日去重IP达220W+，可选城市更多。 #### 示例 以下是中转池产品，提取IP接口的响应情况，可以看到 真实访问地址“proxy_ip“与代理服务地址”server“的地址不一样的两个IP。  ## 二、资源池特点 相比与直连池，中转池 - 流水更丰富 - IP段更分散 - 业务成功率更高 ## 三、适合客户群 - 有大量IP使用需求的客户 - 对采集成功率要求高的客户
选择通道提取方式，意味着业务有效期内可同时在线使用的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)
## 1. 接口描述
接口请求域名： overseas.proxy.qg.net。
本接口 (/query) 用于全球HTTP-短效代理产品通道提取模式下查询在用的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 | 请求频率超出限制。 |
## 1. 接口描述 接口请求域名： overseas.proxy.qg.net。 本接口 (/resources) 用于全球HTTP-短效代理产品通道提取模式下查询国家资源的接口。 默认接口请求频率限制：60次/分钟。 推荐使用调试工具进行调试，[调试工具](https://www.qg.net/tools/IPdebug.html?type=5-2)。 ## 2. 输入参数 | 参数名称 | 必选 | 类型 | 描述 | | -------- | ---- | ------ | ------------------------ | | key | 是 | String | 公共参数，产品唯一标识。 | ## 3. 输出参数 | 参数名称 | 类型 | 描述 | | ---------- | ------------------------------------------------------------ | ------------------------------------------------------------ | | code | String | 请求状态码。 | | data | Array of [ResourceAreaISP](https://www.qg.net/doc/1839.html) | [国家编码](https://www.qg.net/doc/use/8_234_201/1975.html) | | request_id | String | 唯一请求ID，每次请求都会返回。定位问题时需要提供该次请求的 request_id。 | ## 4. 示例 #### 输入示例 ``` GET https://overseas.proxy.qg.net/resources?key=<您的key信息> ``` #### 输出示例 ```json { "code": "SUCCESS", "data": [ { "area": "美国", "area_code": 990100, "country": "US", "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/proxyipResource)。 | | KEY_BLOCK | Key被封禁。 | | REQUEST_LIMIT_EXCEEDED | 请求频率超出限制。 |
活动时间
2020年10月15日- 2020年10月29日 23:59:59
一、邀新·享好礼
云服务器1核2G 内存1M带宽，100%CPU性能，首年88元
云数据库 MySQL，1核1G内存 50G SSD盘，89元1年
CDN境内流量， 2TB 120元1年
直播流量包 1TB 146元 1年
国内短信 1万条340元
云服务器 2核4G 内存1M带宽，年付225元.（限新用户）
云数据库 MySQL，MySQL，1核1G内存 50G SSD盘，89元1年
CDN境内流量包，100GB 9.9元
直播流量包 5TB 814元
对象存储COS 500G 85元
邀请新用户购买本活动商品获积分（6选1）
每成功邀请1人积1分，上限6积分
积分可兑换优惠新购资格，更可免费兑换云资源
二、累计订单享10%满返
每满1000返100，单个账号封顶发放5000元无门槛代金券；
低于2折的商品不参与此活动，云市场商品不参与此活动；
12月17日统计11.11有效订单，统一发放。
举例：小云在11.11活动页面（预热页、主会场、云产品分会场）共消费11887元，则在12月17日会收到满返活动的1100元无门槛代金券
三、代金券·大礼包
一键领取总价值11000元，新购、续费、升级不用愁
活动参与流程：
1、未注册的用户前往腾讯云注册账号，已有注册的用户可直接进行登录，并进行企业认证
2、点击链接 http://manage.qcloud.com/bind_agent.php?agentKey=509448002551e569ecb506 关联到我司名下
3、选择活动促销产品进行下单，入口https://cloud.tencent.com/act/double11/go?from=13490
4、支付环节选择代付模式，在订单列表中找到已下订单并点击查看详情，在详情中找到子订单号（可咨询客服）
5、到我司代付结算页面https://www.qg.net/business/qcloud-pay.html提交子订单号进行代付
## 一、提取方式介绍： 选择均匀提取方式，则用户每分钟能提取到的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)
**全球HTTP均不支持在中国大陆地区网络环境下使用**。 #### 一、介绍 数据中心池，顾名思义，其IP资源来自全球各地的大型数据中心，由知名的云计算服务商控制。 目前，数据中心池IP资源覆盖了全球60+个国家地区，日去重数达100W+，拥有高质的代理服务质量，能够稳定、可靠地满足用户的各类需求。  *数据中心池IP直接表现在IP信息上的是所属ASN的type类型为business（或hosting）。 #### 二、资源池特点 相比于住宅池，数据中心池 - 由知名云厂商统一管理控制，网络更加稳定 - 性价比更高 #### 三、适用客户群 - 追求高性价比的客户 - 不要求住宅网络，更在意稳定性的客户 [开始选用【数据中心池】套餐＞](https://www.qg.net/business/proxyip.html?region=overseas&product_type=3)
## 1. 接口描述 接口请求域名： overseas.proxy.qg.net。 本接口 (/channels) 用于全球HTTP-短效代理产品通道提取模式下查询通道数的接口。 默认接口请求频率限制：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 | 请求频率超出限制。 |
## 1 说明
通过编码使用短效代理-均匀提取主要有以下4步骤：
1.先在[提取工具](https://www.qg.net/tools/IPget.html?type=2-2 "提取工具")或[调试工具](https://www.qg.net/tools/IPdebug.html?type=2-2 "调试工具")上获取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_266/2259.html)
- [balance](https://www.qg.net/doc/product/6_255_263_266/2260.html)
- [resources](https://www.qg.net/doc/product/6_255_263_266/2261.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_267/2139.html)
[按量提取 ＞](https://www.qg.net/doc/product/6_255_263_265/2140.html)
