查询

产品使用

API文档>产品使用>资源相关 > 申请IP资源

申请IP资源

发布时间：2022-04-14 13:16

1.接口描述

接口地址： https://proxy.zzqidc.com/allocate

本接口是用于请求申请代理IP资源的。

请求频率限制：按时业务是（通道数*5＋10）次/分钟；按量业务则是60次/分钟；

方法：HTTP、GET，需要注意不能混合使用；

编码：参数和返回内容均采用utf-8编码。

2.输入参数说明

参数名 是否必选 类型 描述
Key 是 String 申请的Key值
Num 否 Integer 申请的数量;默认1个
KeepAlive 否 Integer 生存周期;默认动态独享24小时,动态共享默认购买的套餐存活周期时长
AreaId 否 Integer 区域ID;默认随机
ISP 否 Integer 运营商ID;默认随机
Detail 否 Integer 详情0(关闭) 1(开启) ，默认为 0
Distinct 否 Integer 去重0(关闭) 1(开启) ，默认为 0

业务为按量动态共享时，参数“KeepAlive“、”Distinct”无须输入；
业务为按时动态共享、按时静态独享时，参数“KeepAlive“无须输入。

3.返回值

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

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

4 示例

请求接口示例：

  1. https://proxy.zzqidc.com/allocate?Key=请改成您的Key

返回示例：

  1. {
  2. "Code ":0,
  3. "TaskID ":"91107E16D28AC5A",
  4. "Num " : "1"
  5. "Data": [
  6. "IP ": "127.0.0.1",
  7. "port ": "49168",
  8. "deadline ": "2018-05-11 02:56:02",
  9. "host ": "127.0.0.1:49168",
  10. ]
  11. }

5.错误码

错误码 描述
0 申请数量一次最多只能100个
-1 未知错误
-10 参数不合法
-11 请求过于频繁
-100 计划不存在或已过期
-101 请求数量超过计划通道数
-102 没有剩余的可用通道
-103 资源不足
-104 资源申请失败
-105 申请的IP数超过允许申请的IP数
上一篇：没有了 下一篇：
申请独占资源
相关文章
申请IP资源
申请独占资源
获取IP资源池
查询IP资源
释放IP资源
查询可用独占资源
本文导读

客户热线：037125966675
客户服务中心
云产品 服务器 合 作                  Skype