提取IP资源-产品介绍-青果网络

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格式，字段说明如下：

参数名	类型	描述
Code	Integer	结果编码，0：成功；-1：失败
TaskID	Integer	任务ID
Num	Intger	申请数量
Data	Array	代理IP数据信息，包含节点IP、端口、失效日期
Msg	String	区域ID，多个用”,”分割；*代表全部

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数