Ping
用于对指定主机进行一次简单的 Ping 操作,并返回 Ping 的结果。
请求方式
GET
返回格式
JSON
接口状态
13,993 次调用
基本信息
请求参数
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| 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 | 通用场景 |
在线调试
响应结果
等待请求
// 点击“发送请求”后,响应结果会显示在这里
PHP 示例代码
无
返回示例
成功响应示例:
{
"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
}
免责声明
本服务仅供个人学习、学术研究目的使用。用户应确保不得利用本服务进行违法违规、侵犯他人合法权益或危害公共安全的行为。因用户使用本服务所产生的风险和责任,由用户自行承担。