用于对指定主机进行一次简单的 Ping 操作,并返回 Ping 的结果。
参数名 | 类型 | 必填 | 说明 |
---|---|---|---|
msg | string | ✅ | 要 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 |
状态码 | 说明 | 常见场景 |
---|---|---|
200 | 请求成功,返回 Ping 结果 | 通用场景 |
400 | 缺少必要参数 msg | 通用场景 |
// 响应结果将显示在这里
无
成功响应示例:
{
"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
}