隧道代理 - 获取当前隧道代理服务器的API接口
站大爷
官方
2024-12-13
请使用合理的频率去调用API接口，暴力调用将导致您的客户端IP被防火墙封禁。
隧道代理IP的使用方式是在软件或程序中设置代理host直接使用，无需通过API提取IP，也无需处理换IP的逻辑；
如果您只能通过API提取代理，此接口可以满足这个需求，但请注意调用频率限制；
默认将显示"主服务器"的IP，如果主服务器宕机，此接口将返回"备用服务器"的IP。
1 接口说明
| 属性 | 内容 |
|---|---|
| URL | http://www.zdopen.com/TunnelProxy/GetIP/ |
| 方法 |
GET POST
|
| 编码 |
utf-8
|
| 参数说明 |
inst_id：实例ID；akey：实例的akey，由该实例的密码通过16位MD5加密得出；pt：代理协议，1表示"Http或Https"(默认)，2表示"Socks4或Socks5"；type：返回类型，1表示"Text文本"，2表示"XML"，3表示"JSON"。 |
| 响应 |
code：错误编号；msg：描述信息；data：数据体；count：代理IP数量；proxy_list：代理IP列表； |
| 错误编号 |
10001：获取成功；12001：akey错误；12002：调用频率过快，请至少1秒调用一次；12003：参数不完整或有错误；12004：该实例不存在或已过期；12005：该实例已过期；12006：该实例已被冻结或禁用；
|
2 接口示例
请求：
GET /TunnelProxy/GetIP/?inst_id=1234567890&akey=8a17ca305f683620&pt=1&type=3 HTTP/1.1 Host: www.zdopen.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": 1,
"proxy_list": [
{
"ip": "test2.zdaye.com",
"port": 10000
}
]
}
}
