接口地址:https://proxy.yunkv.com/extract
本接口用于获取IP资源池全部可用的IP信息,该接口仅按时动态共享业务可用。
该接口单个Key的请求频率限制为60次/分钟;
需要注意的是请求方方式只能用GET;
编码:参数和返回内容均采用utf-8编码。
参数名 | 是否必选 | 类型 | 描述 |
---|---|---|---|
Key | 是 | String | 申请的Key值 |
Num | 否 | Interger | 申请的数量;默认为1 |
AreaId | 否 | Integer | 区域ID;默认随机 |
ISP | 否 | Integer | 运营商ID;默认随机 |
Detail | 否 | Interger | 详情0(关闭) 1(开启) ,默认为 1 |
接口可返回文本格式、json格式、xml格式,字段说明如下:
类型 | 描述 |
---|---|
Integer | 结果编码:0(成功)-1(失败) |
Integer | 任务ID |
Intger | 申请数量 |
Array | 代理IP数据信息,包含节点IP、端口、失效日期 |
String | 区域ID |
请求接口示例:
返回示例:
{
"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"
}
错误码 | 描述 |
---|---|
-1 | 未知错误 |
-10 | 参数不合法 |
-11 | 请求过于频繁 |
-100 | 计划不存在或已过期 |
-101 | 请求数量超过计划通道数 |
-102 | 没有剩余的可用通道 |
-103 | 资源不足 |