# 全网延迟检测 ping

**请求方式：** GET

**接口地址：** https://api.hk0.cc/api/ping

**接口描述：** 多节点延迟检测: 通过遍布国内的监测节点对目标域名发起 ICMP 探测, 返回各节点的平均延迟、丢包与所在地区, 用于评估目标网站的国内连通性。参数: host=要检测的域名(必填); nodes=节点数量(可选, 不传则返回全部大陆节点)。

## 请求参数

| 参数名 | 可传值说明 | 传入位置 | 是否必填 | 示例值 | 默认值 | 参数说明 |
|--------|----------|----------|----------|--------|--------|----------|
| host | string | query | 可选 | — | — | 要检测的域名(必填)，如 example.com；仅限合法域名 |
| nodes | num | query | 可选 | — | — | 可选。不传则返回全部大陆监测节点; 传 >=1 则仅返回指定数量的节点 |

## 返回示例

```json
GET /api/ping?host=baidu.com&nodes=5
```