免费全球多节点Ping检测API接口教程

什么是PING接口-PLUS全球版？详解全球多节点Ping检测API

PING接口-PLUS全球版是一款由接口盒子开发的第三方全球Ping探测API。采用自研并发多线检测协议，调度遍布全球20多个国家、数十个检测节点，可对您指定的IP或域名发起多节点Ping检测。通常在3至15秒内即可获取各节点的延迟数据。

相比在服务器上手动执行ping命令，这款API的优势体现在三个核心层面：

全球化视角：覆盖全球20余个检测节点，远超单机Ping能力；
定向探测：通过dy参数可指定单个城市节点检测，或设置dy=0一次性获取全部节点结果；
地理与IP情报：返回数据中包含目标IP、实际host、运营商及经纬度信息，远不止延迟数据。

API请求说明

请求地址：https://接口盒子/api/wangzhan/pingplus.php
请求方式：支持GET或POST
超时建议：建议设置请求超时时间不少于20秒（等待全球节点并发返回结果）

请求参数

参数

必填

说明

id

✅

用户中心的数字 ID，例：10000000

key

✅

用户中心通讯秘钥

host

✅

要 Ping 的目标 IP 或域名，域名不要带 http://，例：www.apihz.cn

dy

❌

检测地域编号，默认 0（所有节点）。10001=，10002=国外，10003=获取地域列表

返回数据结构详解

返回数据的顶层结构如下：

datas[]数组中各节点的核心字段说明：

字段

含义

code

节点级状态码，200 / 400

totime

Ping 延时（ms），因节点负载/网络波动建议多次取参考

tohost

目标 host

torealhost

目标实际解析 host（CNAME 链终点）

toip

目标 IP

jdxlmsg

检测节点线路描述，如"中国-上海-BGP-2"

调用示例

下面以示例域名www.***.cn进行演示，请将id和key替换为您自己的参数。

GET 调用（浏览器或 curl 都能测）

当 dy=0 时，会触发全球所有节点并发检测，返回几十个节点的 datas[]。

PHP 示例（cURL GET）

如果想走 POST 方式，加上 curl_setopt($ch, CURLOPT_POST, true)，再把参数放进 CURLOPT_POSTFIELDS 即可，逻辑完全一样。

Python 示例（requests）

4s} ms"\n f" | IP:{node['toip']}"\n )\n else:\n print(f"{node.get('jdxlmsg','--')} 失败：{node.get('msg','')}")\nelse:\n print("接口错误：", data["msg"])","id":"L3Hr9"}">

常见错误与注意事项

超时时间切勿设置过短：全球节点并发回包耗时较长，官方建议调用方超时至少20秒，否则可能返回不完整数据或空数组。
域名禁止携带协议头：例如host=https://www.xxx.com为错误写法，正确格式为host=www.xxx.com。

总结与适用场景

如果您希望无需部署海外服务器即可一次性获取全球数十个节点的Ping延迟数据，那么PING接口-PLUS全球版在免费API中节点覆盖较为全面。无论使用PHP还是Python，仅需几行代码即可集成到监控脚本中，非常适合站点出海前的网络质量摸底。