短效优质代理 - 获取代理IP的API接口
站大爷
官方
2024-01-12
21097 浏览
请使用合理的频率去调用API接口，暴力调用将导致您的客户端IP被防火墙封禁。
建议每隔10秒一次调用，以及时获取更新的代理IP。
1 接口说明
| 属性 | 内容 |
|---|---|
| URL | http://open.***.com/ShortProxy/GetIP/ |
| 方法 | GET POST |
| 编码 | utf-8 |
| 参数说明 | api：实例ID；akey：实例的akey，由该实例的密码通过16位MD5加密得出；count(可选)：提取数量, 不能超过该实例的"单提限量"，默认值等于"单提限量"；adr(可选)：ip的地理位置筛选关键词，多关键词以半角逗号隔开，字符串使用UrlEncode编码；timespan：IP剩余存活时间，赋值范围为0-5，比如3，表示3-6分钟，注意选择最低存活时间越长，连续提取结果中的IP重复率可能越高；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：调用频率过快，请至少10秒调用一次；12003：参数不完整或有错误；12004：该实例不存在或已过期；12005：该实例已过期；12006：该实例已被冻结或禁用；12007：该实例当前授权模式为"终端IP授权"，但尚未绑定使用者终端IP；12008：该实例使用额度已经超限；12009：该参数条件下当前没有任何代理IP。 |
2 接口示例
请求：
GET /ShortProxy/GetIP/?api=1234567890&akey=8a17ca305f683620&count=5×pan=3&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:46:56 GMT
Content-Length: 381
{
"code": "10001",
"msg": "获取成功",
"data": {
"count": 5,
"proxy_list": [
{
"ip": "218.87.211.184",
"port": 55528,
"adr": "江西省上饶市 电信",
"timeout": 277,
"cometime": 83
},
{
"ip": "119.52.54.65",
"port": 49345,
"adr": "吉林省松原市 联通",
"timeout": 186,
"cometime": 174
},
{
"ip": "42.235.121.54",
"port": 35938,
"adr": "河南省洛阳市 联通",
"timeout": 327,
"cometime": 33
},
{
"ip": "113.117.66.92",
"port": 45205,
"adr": "广东省揭阳市普宁市 电信",
"timeout": 192,
"cometime": 168
},
{
"ip": "180.118.134.4",
"port": 18270,
"adr": "江苏省镇江市 电信",
"timeout": 356,
"cometime": 4
}
]
}
}
