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 報告或已渲染的狀態圖。