分享页面

查询IP资源

1 接口描述

接口地址:https://proxy.qg.net/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 示例

请求接口示例:

curl "https://proxy.qg.net/query?Key=请改成您的Key"

返回示例:

{
  "Code": 0,
  "TaskList": [
    {
      "TaskID": "91107E16D28AC5A",
      "Num": 1,
      "Data": [
        {
          "IP": "127.0.0.1",
          "port": "21504",
          "deadline": "2022-11-18 15:06:05",
          "host": "114.231.8.147:21504"
        }
      ]
    }
  ],
  "TaskNum": 1,
  "TotalNum": 1
}

重点:在共享企业池的产品中使用该接口,查询出来的IP资源Data结构中的host和IP是不一样的,其他产品下host和IP是一样的。企业池产品中用户使用host进行代理,这时真实的代理IP为IP字段的IP(运营商为移动的情况下可能不会那么准确,即使代理IP可能不通,也都是同一个地区的IP,影响不会大)

5 接口返回错误码

错误码 描述
-1 未知错误
-10 参数不合法
-11 请求过于频繁
-12 Authkey被封禁
-100 计划不存在或已过期
本文导读