Ping
检测公网主机 TCP 80 端口连接延迟（毫秒），不是 ICMP Ping；限制公网地址，连接超时 3 秒。
GETJSON已发布版本 1.0
快速接入
QUICK START- 01查看参数说明选择请求方式与取值
- 02查看实际响应
- 03复制代码开始接入按你的开发语言选择
示例请求
每个 IP 每分钟 120 次；图片接口可能另有较低额度。限流时请按 Retry-After 等待。
请求参数
| 参数 | 类型 / 必填 | 示例 / 默认 | 说明 / 取值 |
|---|---|---|---|
msg | string · 必填 | api.keguan.org.cn默认：无 | 要 Ping 的主机名或 IP 地址 |
返回字段
| 字段 | 类型 | 说明 |
|---|---|---|
status | integer | 响应状态码 |
message | string | 响应消息 |
data | object | 包含 Ping 操作相关数据的对象 |
data.host | string | 要 Ping 的主机名或 IP 地址 |
data.ip | string | 主机对应的 IP 地址 |
data.ping_results | array | 包含每次 Ping 结果的数组 |
data.ping_results[].success | boolean | 表示本次 Ping 是否成功 |
data.ping_results[].message | string | Ping 结果的描述信息 |
data.ping_results[].time | integer | Ping 的响应时间（毫秒），若失败则为 null |
返回示例
成功响应示例：
{
"status": 200,
"message": "请求成功",
"data": {
"host": "api.keguan.org.cn",
"ip": "93.184.216.34",
"ping_results": [
{
"success": true,
"message": "Ping 成功",
"time": 20
}
]
}
}
错误响应示例：
{
"status": 400,
"message": "缺少必要参数 msg",
"data": null
}错误说明
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 400 | 请求参数无效 |
| 405 | 请求方法不支持 |
| 413 | 请求内容过大 |
| 429 | 请求过于频繁 |
| 502 | 上游服务不可用 |
| 503 | 接口维护中 |
400：检查参数；429：按 Retry-After 等待；503：维护中；502：上游暂不可用，可稍后重试或反馈。
响应结果
RESPONSE点击发送请求后查看响应。
接入代码
INTEGRATION代码根据当前请求方式和参数生成。先到在线调试填入参数，再复制到自己的程序。
站长补充的 PHP 示例
<?php
$url = 'https://api.keguan.org.cn/api/ping/api.php?msg=api.keguan.org.cn';
$ch = curl_init($url);
curl_setopt_array($ch, [CURLOPT_RETURNTRANSFER => true, CURLOPT_CONNECTTIMEOUT => 5, CURLOPT_TIMEOUT => 30, CURLOPT_SSL_VERIFYPEER => true, CURLOPT_SSL_VERIFYHOST => 2]);
$response = curl_exec($ch);
$status = curl_getinfo($ch, CURLINFO_HTTP_CODE);
$contentType = curl_getinfo($ch, CURLINFO_CONTENT_TYPE);
if ($response === false) { throw new RuntimeException(curl_error($ch)); }
curl_close($ch);
if ($status >= 400) { throw new RuntimeException('HTTP ' . $status . ': ' . $response); }
header('Content-Type: ' . ($contentType ?: 'application/octet-stream'));
echo $response;