POST公开旧版拨测PingTCPingDNSHTTP网络vv1

ITDOG 多地拨测(旧版)

迁移自旧 ItDog:对域名/URL 做多地 ping、tcping、DNS、HTTP 拨测,返回每个节点的耗时、状态与解析结果。旧接口用内网 Docker 节点,新实现改用公开多节点拨测上游 check-host.net。

/api/ItDog
在线调试
频率限制按方案
每日额度按方案
所需权限无

接口说明

迁移自旧 ItDog:对域名/URL 做多地 ping、tcping、DNS、HTTP 拨测,返回每个节点的耗时、状态与解析结果。旧接口用内网 Docker 节点,新实现改用公开多节点拨测上游 check-host.net。

请求参数

请求体为 JSON;未在接口定义中列出的字段一般会被忽略,但个别 Provider 单独校验的接口仍可能拒绝未声明字段;已定义字段仍会做类型、长度与枚举校验。

字段类型说明
0string测试类型:ping / tcping / dns / http(旧接口的路径参数)
uastringhttp 测试时带的 User-Agent
refstringhttp 测试时带的 Referer
ipv4stringhttp 测试时指定 IPv4
portuniontcping 端口,缺省 80
typestring旧返回格式参数;新平台统一返回 JSON
actionstring测试类型的路由别名(/v1/gateway/legacy-itdog/:action)
cookiestringhttp 测试时带的 Cookie
domain*string目标域名或 URL(ping/tcping/dns 会自动去掉协议)
methodstringhttp 测试时对目标使用的请求方法(缺省 get)

返回参数

成功响应中 data 内的字段(不含信封的 code / message / meta)。未列出的字段可能随版本增加,请忽略未知字段。

请求示例

request.json
{
  "0": "ping",
  "domain": "example.com"
}

返回示例

response.json
{
  "code": 1,
  "data": {
    "host": "example.com",
    "method": "ping",
    "results": [
      {
        "node": "hk1.node.check-host.net",
        "delay": 3.42,
        "status": "OK",
        "address": "104.20.23.154"
      }
    ],
    "permanentLink": "https://check-host.net/check-report/…"
  },
  "message": "================\n耗时:3.42ms\n节点:Hong Kong Hong Kong (hk1.node.check-host.net)\n地址:104.20.23.154"
}

所有接口统一返回 { code, message, data, error_code?, details?, meta }。 成功 code = 1;失败 code 为唯一负数(如 -10001)并给出结构化 error_code, 错误码说明 →