网络

Ping 主机

0次调用
1 积分/次

想知道从我们的服务器到你的服务器网络延迟高不高?这个工具可以帮你测试网络连通性。

GET
uapis.cn
/api/v1/network/ping
查询参数
1
host
string
required

你需要 Ping 的目标主机,可以是域名或IP地址。

功能概述

这个接口会从我们的服务器节点对你指定的主机(域名或IP地址)执行 ICMP Ping 操作。它会返回最小、最大、平均延迟以及丢包率等关键指标,是诊断网络问题的得力助手。

查询参数

host
string必填

你需要 Ping 的目标主机,可以是域名或IP地址。

响应

200 / 请求成功

Ping 操作成功!返回延迟统计数据。

JSON
{
  // 平均延迟(ms)
  "avg": 1.25,
  "host": "cn.bing.com",
  "ip": "142.250.191.78",
  "location": "美国",
  // 最大延迟(ms)
  "max": 2.1,
  // 最小延迟(ms)
  "min": 0.89
}

400 / 错误的请求

请求失败,参数无效或目标不可达。前端可直接展示 message 字段。

可能原因:

  • 无法解析主机: host 参数是一个无效的域名或IP地址。
    JSON
    {
        "code": "INVALID_PARAMETER",
        "message": "无法解析主机 '无效的主机名',请检查输入是否正确。"
    }
  • Ping 超时: 目标主机无法访问或被防火墙拦截。
    JSON
    {
        "code": "INVALID_PARAMETER",
        "message": "对主机 '目标主机' 的 Ping 请求超时,目标可能不可达或防火墙已拦截。"
    }
JSON
{
  "code": "INVALID_PARAMETER",
  "message": "无法解析主机 '无效的主机名',请检查输入是否正确。"
}

429 / 请求过于频繁

服务繁忙。当服务器 Ping 请求过多时,会触发限流。前端可直接展示 message 字段。

JSON
{
    "code": "SERVICE_BUSY",
    "message": "Ping 服务正忙,请稍后再试。"
}
JSON
{
  "code": "SERVICE_BUSY",
  "message": "Ping 服务正忙,请稍后再试。"
}