隧道代理 - 查询隧道及当前IP的API接口
站大爷
官方
2024-12-13
333 浏览
请使用合理的频率去调用API接口，暴力调用将导致您的客户端IP被防火墙封禁。
隧道代理IP的特点是设置一次代理，之后会定期在云端自动切换IP，因此主流的使用方式您无需通过API提取IP，也无需处理换IP的逻辑；
此接口是用于实时查询隧道列表以及当前IP；
此接口仅支持显示换IP周期>=30秒的隧道；
如果您的使用场景需要先提取代理IP，请使用获取当前隧道代理服务器的API接口。
1 接口说明
| 属性 | 内容 |
|---|---|
| URL | http://open.***.com/TunnelProxy/GetTransRuleIP/ |
| 方法 | GET POST |
| 编码 | utf-8 |
| 参数说明 | inst_id：实例ID；akey：实例的akey，由该实例的密码通过16位MD5加密得出；sid：返回此sid对应的隧道信息，不传时返回该实例下当前所有的隧道信息。 |
| 响应 | 响应为json格式。响应字段如下：code: 错误编号；msg: 描述信息；data: 隧道信息。 |
| 错误编号 | 10001：获取成功；12001：akey错误；12002：调用频率过快，请至少1秒调用一次；12003：参数不完整或有错误；12004：该实例不存在或已过期；12005：该实例已过期；12006：该实例已被冻结或禁用；12011：该用户尚未完成实名认证；12012：该用户涉嫌违规行为；12020：获取失败。 |
2 接口示例
请求：
GET /TunnelProxy/GetTransRuleIP/?inst_id=1234567890&password=8a17ca305f683620 HTTP/1.1
Host: open.***.com响应：
HTTP/1.1 200 OK
Content-Type: application/json; charset=utf-8
Date: Thu, 25 Apr 2019 10:55:03 GMT
Content-Length: 37
{
"code": "10001",
"msg": "获取成功",
"data": {
"sid1": "125.35.67.63",
"sid2": "61.129.2.212"
}
}
