合租IP池 - 获取代理IP的API接口
站大爷
官方
2024-01-16
3008 浏览
请使用合理的频率去调用API接口，暴力调用将导致您的客户端IP被防火墙封禁。
建议每隔10秒一次调用，以及时获取更新的代理IP。
1 接口说明
| 属性 | 内容 |
|---|---|
| URL | http://open.***.com/CotenancyProxy/GetIP/ |
| 方法 | GET POST |
| 编码 | utf-8 |
| 参数说明 | api：实例ID；akey：实例的akey，由该实例的密码通过16位MD5加密得出；count(可选)：提取数量, 不能超过该实例的"单提限量"，默认值等于"单提限量"；adr(可选)：ip的地理位置筛选关键词，多关键词以半角逗号隔开，字符串使用UrlEncode编码；nadr(可选)：ip的排除地理位置关键词，多关键词以半角逗号隔开，字符串使用UrlEncode编码；pro：代理协议，1表示"HTTP(S)"，2表示"Socks5"；timespan：IP剩余存活时间，表达式为timespan-10分钟，例如值为3，则表示3-10分钟；order：排序方式，1表示"按预计剩余存活时间从长到短"，2表示"随机抽取"；type：返回类型，1表示"Text文本"，2表示"XML"，3表示"JSON"。 |
| 响应 | 返回内容的标签或字段类型可在产品管理里通过设置提取格式来定制； 类型为 Text文本的定制标签如下：{ip}：ip地址；{port}：端口；{adr}：地理位置；{timeout}：预计剩余存活时间(秒)；{cometime}：上线时间(秒)。类型为 XML或JSON格式的响应字段如下：code：错误编号；msg：描述信息；data：数据体；count：代理IP数量；proxy_list：代理IP列表；ip：ip地址；port：端口；adr：地理位置；timeout：预计剩余存活时间(秒)；cometime：上线时间(秒)。 |
| 错误编号 | 10001：获取成功；12001：akey错误；12002：调用频率过快，请至少1秒调用一次；12003：参数不完整或有错误；12004：该实例不存在或已过期；12005：该实例已过期；12006：该实例已被冻结或禁用；12007：该实例当前授权模式为"终端IP授权"，但尚未绑定使用者终端IP；12008：该实例使用额度已经超限；12009：该参数条件下当前没有任何代理IP。 |
2 接口示例
请求：
GET /CotenancyProxy/GetIP/?api=1234567890&akey=8a17ca305f683620&pro=1&count=5&order=2&type=3 HTTP/1.1
Host: open.***.com响应：
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Thu, 25 Apr 2019 10:41:50 GMT
Content-Length: 369
{
"code": "10001",
"msg": "获取成功",
"data": {
"count": 5,
"proxy_list": [
{
"ip": "223.241.180.245",
"port": 41301,
"adr": "安徽省安庆市 电信",
"timeout": 76,
"cometime": 284
},
{
"ip": "36.26.119.214",
"port": 39557,
"adr": "浙江省 电信",
"timeout": 101,
"cometime": 259
},
{
"ip": "59.54.101.209",
"port": 26599,
"adr": "江西省九江市 电信",
"timeout": 196,
"cometime": 164
},
{
"ip": "125.87.107.132",
"port": 47852,
"adr": "重庆市 电信",
"timeout": 318,
"cometime": 42
},
{
"ip": "182.91.221.128",
"port": 29841,
"adr": "广西桂林市 联通",
"timeout": 263,
"cometime": 97
}
]
}
}
