Ping

用于对指定主机进行一次简单的 Ping 操作,并返回 Ping 的结果。

GET
请求方式
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
}

免责声明

本服务仅供个人学习、学术研究目的使用。用户应确保不得利用本服务进行违法违规、侵犯他人合法权益或危害公共安全的行为。因用户使用本服务所产生的风险和责任,由用户自行承担。
已复制