接口地址：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
请求参数说明：
| 参数名称 | 必填 | 类型 | 说明 |
|---|---|---|---|
| username | 是 | string | 用户名 |
| key | 是 | string | 密钥 |
| nodeid | 否 | string | 节点地区ID，默认：中国_河南省_郑州BGP节点 支持自选节点检测，节点标签之间用|间隔，例如gz_bgp|us_la|cn_hk则检测广州节点、洛杉矶节点和香港节点，上限为5个。 |
| url | 是 | string | 需要检测的URL地址 |
返回参数说明：
| 参数名称 | 类型 | 说明 |
|---|---|---|
| code | number | 1001为全部节点Ping正常 1002为部分或全部节点Ping超时 |
| msg | string | 系统返回提示信息！ |
| statu | string | 异常为false，正常为true！ |
| count | number | 点数包，如按量计费则返回！ |
| reason | string | 拦截原因，如有则返回！ |
| describe | string | 拦截描述，如有则返回！ |
| url | string | 检测的地址！ |
响应文本：
{
"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 | 用户名不能空 | |
| -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/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()函数控制调用频率