在线网络PING接口检测服务器连通状态免费API教程

接口盒子提供免费的PING检测API，用于测试域名或IP的连通性和响应速度。支持指定地域节点，是服务器运维和网络监控的实用工具。

​接口功能​

对指定域名/IP进行PING检测，返回耗时、实际IP、节点位置等信息。若目标服务器禁PING则失败。

​请求地址​

复制

https://cn.apihz.cn/api/wangzhan/ping.php  

​请求方式​

支持 ​GET​ 或 ​POST​

​请求参数​

​返回参数​

json

复制

{  
  "code": 200,       // 状态码（200成功，400失败）  
  "msg": "ok",       // 提示信息  
  "time": "33.1",    // 耗时（毫秒）  
  "host": "www.apihz.cn",         // 原始地址  
  "realhost": "bd-l7-online...",  // 实际地址（如CDN节点）  
  "ip": "125.64.35.108",          // 实际IP  
  "dy": "国内",                   // 节点地域  
  "dz": "上海"                    // 节点详细位置  
}  

调用示例

​1. GET请求​

直接在URL中传递参数：

复制

https://cn.apihz.cn/api/wangzhan/ping.php?id=您的ID&key=您的KEY&host=www.apihz.cn&type=1  

​2. POST请求​

​PHP示例​

php

复制

<?php  
$url = "https://cn.apihz.cn/api/wangzhan/ping.php";  
$data = [  
    'id'  => '您的ID',      // 替换为实际ID  
    'key' => '您的KEY',     // 替换为实际KEY  
    'host' => 'www.apihz.cn',  
    'type' => 1  
];  

// 发送POST请求  
$ch = curl_init();  
curl_setopt($ch, CURLOPT_URL, $url);  
curl_setopt($ch, CURLOPT_POST, true);  
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query($data));  
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);  
$response = curl_exec($ch);  
curl_close($ch);  

// 解析结果  
$result = json_decode($response, true);  
if ($result['code'] == 200) {  
    echo "PING耗时: {$result['time']}ms, 实际IP: {$result['ip']}";  
} else {  
    echo "错误: {$result['msg']}";  
}  
?>  

​Python示例​

python

运行

复制

import requests  

url = "https://cn.apihz.cn/api/wangzhan/ping.php"  
params = {  
    "id": "您的ID",      # 替换为实际ID  
    "key": "您的KEY",    # 替换为实际KEY  
    "host": "www.apihz.cn",  
    "type": 1  
}  

# 发送POST请求  
response = requests.post(url, data=params)  
result = response.json()  

if result['code'] == 200:  
    print(f"PING耗时: {result['time']}ms, 实际IP: {result['ip']}")  
else:  
    print(f"错误: {result['msg']}")  

注意事项

1. ​注册账户​：需在接口盒子免费API官网注册获取专属 id 和 key。
2. ​频率限制​：公共ID（如示例中的88888888）有分钟级限制，私有ID可独享更高频次。
3. ​错误处理​：
   • code=400 时检查参数（如密钥错误、地址无效）。
   • 目标禁PING时会返回失败。