Check-Host.cc

API 文档

来自全球 65+ 节点的分布式网络诊断 — Ping、MTR、DNS、HTTP、TCP 和 UDP — 外加主机元数据、WHOIS 和历史检测报告。下方每个接口都可编辑，且可直接在浏览器中对线上 API 发起请求。

SDK
Node.js
SDK
Python
SDK
PHP 8.1+
SDK
Go
SDK
Java
这是干嘛用的？

匿名访问对大多数场景已经够用。 我们对 IP 和目标分别设置了温和的速率限制 — 如需精确数字请查看 /about 上的完整表格。

API 密钥（UUID 格式）会提高这些限制，并按密钥提供月度配额。密钥免费 — Check-Host 是非营利项目，限制只是为了防滥用，不是为了变现。如果你的合理用例超出了匿名档位，请通过支持联系我们。

Send the key as an Authorization: Bearer <key> header — the code samples below fill this in for you. For backward compatibility an apikey field in a POST body is still accepted; passing it in the URL query string is not.

隐私：密钥仅保存在本页所在浏览器的 localStorage 中，仅会发送到 api.check-host.cc。

快速开始

提交检测是异步的：(1) 向监控接口发起 POST 拿到 UUID，(2) 轮询 /report/{uuid} 直到每个节点都返回结果。大多数检测在 1–10 秒内完成。下方接口会在你点击执行时自动轮询。

轮询模式（bash） 
# 1. Dispatch a check, capture the UUID
UUID=$(curl -s -X POST https://api.check-host.cc/ping \
  -H 'Content-Type: application/json' \
  -d '{"target":"check-host.cc","region":["DE"]}' | jq -r .uuid)

# 2. Poll until at least one node has reported
until curl -s "https://api.check-host.cc/report/$UUID" \
  | jq -e '.data | length >= 1' > /dev/null; do sleep 1; done

curl -s "https://api.check-host.cc/report/$UUID" | jq .

查询

8 个接口

IP、地理位置、WHOIS 以及实时节点列表。

全球检测

12 个接口

从全球 65+ 节点发起 Ping / TCP / UDP / HTTP / DNS / MTR 检测 — 每次调用都会返回 UUID，并随后自动轮询 /report/{uuid} 取结果。

快速 GET 快捷方式

用于简单检测的即用型 URL — 不支持区域选择或 Live 模式（这些请用上方的 POST）。

Network Intelligence

3 个接口

Dispatch deep, multi-stage scans (port + banner + body + TLS + threat-intel) of an IP, CIDR, domain or ASN. Asynchronous: submit, then poll the status endpoint. Open to guests, with per-IP and per-target hourly quotas.

Intelligence Data

8 个接口

Read the aggregated intelligence we already hold for an entity — the same data that powers the /ip, /as, /domain … pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

Geo Intelligence

4 个接口

Country, TLD and continent-level aggregates plus the global threat feed — the same data that powers the /country, /tld, /continent and /threats pages, as JSON. Open to guests with a per-IP rate limit; an API key lifts the limits.

报告

3 个接口

取回先前已发起检测的 JSON 报告或渲染好的状态图。