域名Ping检测(IPv4)

接口地址:https://api.uouin.com/app/ping

返回格式:Json

请求方式:Http(s) Get/Post请求

请求示例:https://api.uouin.com/app/ping?username=用户名&key=密钥&url=https://www.qq.com

接口说明:域名Ping检测可实时检测域名的Ping值,支持多节点检测,支持输入IPV4和域名进行检测,仅支持IPV4的Ping,IPV6 Ping请使用https://api.uouin.com/docs_detail_ping6.html

请求参数说明:

参数名称必填类型说明
usernamestring用户名
keystring密钥
nodeidstring节点地区ID,默认:中国_河南省_郑州BGP节点
支持自选节点检测,节点标签之间用|间隔,例如gz|lta|hk则检测广州节点、意大利节点和香港节点,上限为5个。
urlstring需要检测的URL地址

返回参数说明:

参数名称类型说明
codenumber1001为全部节点Ping正常
1002为部分或全部节点Ping超时
msgstring系统返回提示信息!
statustring异常为false,正常为true!
countnumber点数包,如按量计费则返回!
reasonstring拦截原因,如有则返回!
describestring拦截描述,如有则返回!
urlstring检测的地址!

响应文本:

{
    "msg": "获取成功", 
    "nodecode": {//节点状态码
        "cn": 200, 
        "hk": 200, 
        "us": 200, 
        "lta": 200
    }, 
    //200成功;201超时;-200节点故障;-201请求找不到主机;-202未找到该节点
    "ip": {//获取的IP
        "cn": "61.151.166.139", 
        "hk": "203.205.219.88", 
        "us": "104.94.212.210", 
        "lta": "92.122.247.58"
    }, 
    "ipaddress": {//获取的IP地址
        "cn": "上海市 深圳市腾讯计算机系统有限公司电信节点", 
        "hk": "香港 腾讯云", 
        "us": "美国 Akamai科技公司CDN网络节点", 
        "lta": "德国 法兰克福nLayer Akamai公司CDN网络节点"
    }, 
    "data": {//Ping值
        "cn": "32.092ms", 
        "hk": "1.757ms", 
        "us": "2.578ms", 
        "lta": "0.405ms"
    }, 
    "statu": "true", 
    "url": "https://xw.qq.com/", 
    "code": "1001"
}

系统状态码参考:

 状态码code说明
 -200用户名不能空
 -201key不能空
 -202url不能为空
 -203点数包余额不足
 -204访问API频率超过套餐限制,请升级套餐
 -205请求的接口地址有误,请到API文档获取请求地址
 -206账户VIP会员没开通或已过期
 -207用户名或key不对
 -208非白名单IP,请添加白名单IP
 -209账户状态异常
 -210接口异常,查询失败
 -211账户未绑定手机号
 -212检测超时,请重试
 -213网址存在安全风险,如误报可添加白名单域名
 -214API功能未开通
 1001检测域名状态正常
 1002检测域名状态异常或封禁
 200获取数据成功
 1短网址类调用生成成功

对接代码演示:


$result = file_get_contents("https://api.uouin.com/app/ping?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()函数控制调用频率

找不到你想要的?

需要我们的帮助!
联系我们