查询IP资源

发布时间:2022-07-02 02:27

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

返回示例:

  1. {
  2. "Code ":0,
  3. "TotalNum":5,
  4. "TaskNum":5,
  5. "TaskList ": [
  6. {
  7. "IP ": "127.0.0.1",
  8. "port ": "49168",
  9. "deadline ": "2018-05-11 02:56:02",
  10. "host ": "127.0.0.1:49168",
  11. }
  12. ]
  13. }

5.错误码

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