接口地址:https://api.uouin.com/app/traceroute
返回格式:Json
请求方式:Http(s) Get/Post请求
请求示例:https://api.uouin.com/app/traceroute?username=用户名&key=密钥&url=https://www.baidu.com
接口说明:路由追踪(Traceroute)是路由跟踪命令,可追踪本地主机到目标地址的链路路由,通过路由追踪可了解目标地址链路路由是否正常以及目标地址实际主机位置。
请求参数说明:
参数名称 | 必填 | 类型 | 说明 |
---|---|---|---|
username | 是 | string | 用户名 |
key | 是 | string | 密钥 |
nodeid | 否 | string | 节点地区ID,默认:中国_河南省_郑州BGP节点 |
url | 是 | string | 需要检测的URL地址 |
返回参数说明:
参数名称 | 类型 | 说明 |
---|---|---|
code | number | 1001为获取成功 1002为获取超时 |
msg | string | 系统返回提示信息! |
statu | string | 异常为false,正常为true! |
count | number | 点数包,如按量计费则返回! |
reason | string | 拦截原因,如有则返回! |
describe | string | 拦截描述,如有则返回! |
url | string | 检测的地址! |
响应文本:
{
"msg": "获取成功",
"data": [
{
"network_ip": "122.114.171.254",
"network_addr": "河南省郑州市 景安BGP数据中心",
"network_time": "0.549 ms"
},
{
"network_ip": "172.31.12.3",
"network_addr": "局域网 对方和您在同一内部网",
"network_time": "0.528 ms"
},
{
"network_ip": "218.28.198.221",
"network_addr": "河南省郑州市 联通",
"network_time": "16.110 ms"
},
{
"network_ip": "115.60.218.213",
"network_addr": "河南省郑州市 联通",
"network_time": "0.847 ms"
},
{
"network_ip": "*",
"network_addr": "*",
"network_time": "*"
},
{
"network_ip": "219.158.98.117",
"network_addr": "中国 联通骨干网",
"network_time": "18.283 ms"
},
{
"network_ip": "110.242.66.170",
"network_addr": "河北省保定市 联通",
"network_time": "21.373 ms"
},
{
"network_ip": "221.194.45.134",
"network_addr": "河北省保定市阜平县 联通",
"network_time": "23.663 ms"
},
{
"network_ip": "*",
"network_addr": "*",
"network_time": "*"
},
{
"network_ip": "*",
"network_addr": "*",
"network_time": "*"
},
{
"network_ip": "*",
"network_addr": "*",
"network_time": "*"
},
{
"network_ip": "110.242.68.4",
"network_addr": "河北省保定市 联通",
"network_time": "22.136 ms"
}
],
"statu": "true",
"url": "https://www.baidu.com",
"code": 1001
}
系统状态码参考:
状态码code | 说明 | |
---|---|---|
-200 | 用户名不能空 | |
-201 | key不能空 | |
-202 | url不能为空 | |
-203 | 点数包余额不足 | |
-204 | 访问API频率超过套餐限制,请升级套餐 | |
-205 | 请求的接口地址有误,请到API文档获取请求地址 | |
-206 | 账户VIP会员没开通或已过期 | |
-207 | 用户名或key不对 | |
-208 | 非白名单IP,请添加白名单IP | |
-209 | 账户状态异常 | |
-210 | 接口异常,查询失败 | |
-211 | 账户未绑定手机号 | |
-212 | 检测超时,请重试 | |
-213 | 网址存在安全风险,如误报可添加白名单域名 | |
-214 | API功能未开通 | |
1001 | 检测域名状态正常 | |
1002 | 检测域名状态异常或封禁 | |
200 | 获取数据成功 | |
1 | 短网址类调用生成成功 |
对接代码演示:
$result = file_get_contents("https://api.uouin.com/app/traceroute?username=用户名&key=密钥&url=".urlencode($url));
$json = json_decode($result,true);
if($json[code] < 0){
echo $json[msg];// API接口异常,返回异常信息
}
if($code == 1001){
echo "域名正常"; //判断code为1001即为正常
}
if($code == 1002){ //判断code为1002即为拦截
echo "已被封禁";
}
//可通过sleep()或usleep()函数控制调用频率