提取IP资源-API接口-青果网络

##  1 接口描述
接口地址： https://proxy.qg.net/allocate ；
本接口是用于请求提取代理IP资源的；
请求频率限制：按时业务是（通道数*5＋10）次/分钟；按量业务则是60次/分钟；
方法：HTTP、GET，需要注意不能混合使用；
编码：参数和返回内容均采用utf-8编码。

##  2 输入参数说明
|参数名|是否必选|类型|描述|
|:----    |:---|:----- |-----   |
|Key  |是  |String |申请的Key值  |
| Num |否  |Integer|申请的数量；默认1个  |
|KeepAlive |否 |Integer | IP生存周期，单位：分钟。仅针对动态独享用户有效，默认为1440分钟(24小时) |
|AreaId |否 |Integer |区域ID；默认随机   |
|ISP |否  |Integer | 运营商ID；默认随机  |
|Detail |否  |Integer|详情，0：关闭；1：开启；默认为0 |
|Distinct  |否  |Integer|去重，仅针对动态独享有效。0：关闭；1：开启；默认为0 |

## 3 返回值
接口可返回文本格式、json格式、xml格式，字段说明如下：

##  4 示例
请求接口示例：
```
curl "https://proxy.qg.net/allocate?Key=请改成您的Key&Num=1"
```
返回示例：
```
{
	"Code": 0,
	"TaskID": "91107E16D28AC5A",
	"Num": "1",
	"Data": [
		{
		 "IP": "127.0.0.1",
		 "port": "49168",
		 "deadline": "2018-05-11 02:56:02",
		 "host": "127.0.0.1:49168"
		}
	]
}
```
**重点：在共享企业池的产品中使用该接口，提取出来的IP资源Data结构中的host和IP是不一样的，其他产品下host和IP是一样的。企业池产品中用户使用host进行代理，这时真实的代理IP为IP字段的IP（运营商为移动的情况下可能不会那么准确，即使代理IP可能不通，也都是同一个地区的IP，影响不会大）**
## 5 接口返回错误码
| 错误码  | 描述  |
| ------------ | ------------ |
| -1   | 未知错误  |
| -10  | 参数不合法 |
| -11  | 请求过于频繁 |
| -12  | Authkey被封禁 |
| -13  | 当前客户端IP不在授权名单中 |
| -14  | Pwd不合法 |
| -15  | Authkey对应的业务无此权限 |
| -100 | 计划不存在或已过期  |
| -103 | 资源不足 |
| -104 | 申请资源失败 |
| -105 | 申请的IP数超过允许申请的IP数 |

青果云

电商云

云代付

服务器租用

服务器托管

整机柜托管

动态共享

动态独享

隧道代理

静态独享

云电脑

拨号VPS

融合CDN

电商浏览器

云手机

实名认证

堡垒机

励销云搜客宝

励销云CRM

励销云SCRM

励销云电话机器人

API文档

提取IP资源