接口盒子提供免费的PING检测API，用于测试域名或IP的连通性和响应速度。支持指定地域节点，是服务器运维和网络监控的实用工具。
接口功能
对指定域名/IP进行PING检测，返回耗时、实际IP、节点位置等信息。若目标服务器禁PING则失败。
请求地址
复制
https://cn.apihz.cn/api/wangzhan/ping.php
请求方式
支持 GET 或 POST
请求参数
| 参数 | 必填 | 说明 |
id |
是 | 用户ID（注册后获取） |
key |
是 | 用户通讯密钥 |
host |
是 | 待检测的域名/IP（如 www.apihz.cn） |
type |
否 | 地域：1(国内，默认)、2(香港)、3(美国) |
返回参数
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']}")
注意事项
- 注册账户：需在接口盒子官网注册获取专属
id和key。 - 频率限制：公共ID（如示例中的88888888）有分钟级限制，私有ID可独享更高频次。
- 错误处理：
code=400时检查参数（如密钥错误、地址无效）。- 目标禁PING时会返回失败。
