一、接口是什么PING 接口-PLUS 全球版是一个第三方 Ping 探测 API由接口盒子自研并发多线检测协议调度全球 20 国家、数十个检测节点对你指定的 IP / 域名发起 Ping一般3–15 秒即可返回各地节点的延时结果。相比自己在服务器上ping一下它的核心价值是✅视角全球化—— 全球20多个检测点✅可定向—— 支持dy参数指定单个城市节点也支持dy0一次性拉全节点✅附带地理/IP 情报—— 返回目标 IP、实际 host、所属运营商、经纬度二、请求说明请求地址https://cn.apihz.cn/api/wangzhan/pingplus.php请求方式GET 或 POST 均可超时建议单次请求 ≥ 20 秒因为要等全球节点并发回包请求参数参数必填说明id✅用户中心的数字 ID例10000000key✅用户中心通讯秘钥host✅要 Ping 的目标 IP 或域名域名不要带 http://例www.apihz.cndy❌检测地域编号默认0所有节点。1000110002国外10003获取地域列表四、返回数据结构最外层jsonjson{ code: 200, // 200 成功400 错误 msg: 信息提示, datas: [ ... ] // 各节点 Ping 结果数组 }datas[]单节点核心字段字段含义code节点级状态码200 / 400totimePing 延时ms因节点负载/网络波动建议多次取参考tohost目标 hosttorealhost目标实际解析 hostCNAME 链终点toip目标 IPjdxlmsg检测节点线路描述如中国-上海-BGP-2五、调用示例下面用示例域名www.apihz.cn演示请把id/key换成你自己的。1️⃣ GET 调用浏览器 / curl 都能测bashbashcurl https://cn.apihz.cn/api/wangzhan/pingplus.php?id88888888key88888888dy0hostwww.apihz.cndy0会触发全球全节点并发返回几十个节点的datas[]。2️⃣ PHP 示例cURL GETphpphp?php /** * PING 接口 PLUS 全球版 - PHP 调用示例 */ $api https://cn.apihz.cn/api/wangzhan/pingplus.php; $id 你的ID; $key 你的KEY; $host www.apihz.cn; $dy 0; // 0全节点, 也可换 1/2/100/923 等 $url $api . ?id . $id . key . $key . dy . $dy . host . $host; $ch curl_init($url); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_TIMEOUT, 25); // 建议 ≥20 秒 $response curl_exec($ch); curl_close($ch); $data json_decode($response, true); if ($data[code] 200) { foreach ($data[datas] as $node) { printf( %-22s | %s ms | IP:%s\n, $node[jdxlmsg], $node[totime], $node[toip] ); } } else { echo 接口错误 . $data[msg] . PHP_EOL; }如果要走POST把curl_setopt($ch, CURLOPT_POST, true)加上参数放CURLOPT_POSTFIELDS即可逻辑一样。3️⃣ Python 示例requestspythonpython PING 接口 PLUS 全球版 - Python 调用示例 pip install requests import requests API https://cn.apihz.cn/api/wangzhan/pingplus.php ID 你的ID KEY 你的KEY HOST www.apihz.cn DY 0 params { id: ID, key: KEY, host: HOST, dy: DY } r requests.get(API, paramsparams, timeout25) r.raise_for_status() data r.json() if data[code] 200: print(f目标 {HOST} 全球 Ping 结果\n) for node in data[datas]: if node[code] 200: print( f{node[jdxlmsg]:22s} f | {node[totime]:4s} ms f | IP:{node[toip]} ) else: print(f{node.get(jdxlmsg,--)} 失败{node.get(msg,)}) else: print(接口错误, data[msg])六、几个容易踩的坑超时别设太短—— 全球节点并发回包慢接口方建议调用侧超时20 秒否则可能拿到半截或空datas域名别带协议头——hosthttps://www.xxx.com❌hostwww.xxx.com✅七、一句话定位如果你需要一个不用自己布海外机、又能一次性看全球几十个点 Ping 延迟的接口这个 PLUS 版算是免费 API 里节点覆盖比较全的一档PHP / Python 几行就能接进监控脚本做站点出海前的网络摸底挺合适。