API文档>使用相关>资源相关 > 获取IP资源池

获取IP资源池

发布时间:2022-06-01 00:00

1.接口描述

接口地址:https://proxy.yunkv.com/extract

本接口用于获取IP资源池全部可用的IP信息,该接口仅按时动态共享业务可用。

该接口单个Key的请求频率限制为60次/分钟;

需要注意的是请求方方式只能用GET;

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

2.输入参数说明

参数名 是否必选 类型 描述
Key String 申请的Key值
Num Interger 申请的数量;默认为1
AreaId Integer 区域ID;默认随机
ISP Integer 运营商ID;默认随机
Detail Interger 详情0(关闭) 1(开启) ,默认为 1

3.返回值

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

类型 描述
Integer 结果编码:0(成功)-1(失败)
Integer 任务ID
Intger 申请数量
Array 代理IP数据信息,包含节点IP、端口、失效日期
String 区域ID

4 示例

请求接口示例:

  1. https://proxy.yunkv.com/extract?Key=请改成您的Key

返回示例:

 

{
  "Code": 0,
  "Data": [
    {
      "IP": "175.43.188.196",
      "port": "64450",
      "deadline": "2021-11-20 11:32:20",
      "host": "175.43.188.196:64450",
      "region": "福建省泉州市晋江市联通"
    },
    {
      "IP": "114.238.148.203",
      "port": "50938",
      "deadline": "2021-11-20 11:32:20",
      "host": "114.238.148.203:50938",
      "region": "江苏省淮安市电信"
    },
    {
      "IP": "117.92.121.222",
      "port": "11136",
      "deadline": "2021-11-20 11:32:20",
      "host": "117.92.121.222:11136",
      "region": "江苏省连云港市电信"
    }
  ],
  "Num": 3,
  "TaskID": "mw13Wq0srzt9uLEt"
}

5.错误码

错误码 描述
-1 未知错误
-10 参数不合法
-11 请求过于频繁
-100 计划不存在或已过期
-101 请求数量超过计划通道数
-102 没有剩余的可用通道
-103 资源不足
本文导读

客户热线:1830934534