查询IP资源

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

1.接口描述

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

本接口用于查询用户可用的代理IP资源列表。

该接口单个Key的请求频率限制为:(通道数*5+10)次/分钟;

方法:HTTP、GET,需要注意不能混合使用;

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

2.输入参数说明

参数名 是否必选 类型 描述
Key String 查询的Key值
TaskID String 任务ID;多个以逗号分割;默认全部
Detail Integer 详情0(关闭) 1(开启),默认为0

3.返回值

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

参数名 类型 描述
Code Integer 结果编码:0(成功)-1(失败)
TotalNum Integer 总IP数
TaskNum Integer 任务数
TaskList Array 任务列表

4.示例

请求接口示例:

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

返回示例:

{
    "Code ":0,
    "TotalNum":5,
    "TaskNum":5,
    "TaskList ": [
        {
           "IP ": "127.0.0.1",
          "port ": "49168",
          "deadline  ": "2018-05-11 02:56:02",
          "host  ": "127.0.0.1:49168",
        }
    ]
}

 

5.错误码

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

客户热线:1830934534