查询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 | 计划不存在或已过期 |