Check-Host.cc

API 文件

來自全球 65+ 節點的分散式網路診斷 — Ping、MTR、DNS、HTTP、TCP 和 UDP — 還有主機後設資料、WHOIS 與歷史檢測報告。下方每個端點都可編輯,並能直接在瀏覽器中對正式 API 發起請求。

這是做什麼用的?

匿名用法可滿足大多數場景。 我們對 IP 與目標各自設了較寬鬆的速率限制 — 需要確切數字請看 /about 上的完整表格

API 金鑰(UUID 格式)會放寬上述限制,並提供每把金鑰的月配額。金鑰免費 — Check-Host 是非營利專案,限制只是為了防濫用,不是為了變現。若你有合理需求超過匿名額度,請透過支援與我們聯繫

隱私:金鑰只會存在本頁瀏覽器的 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 .

查詢

7 個端點

IP、地理位置、WHOIS,以及即時節點清單。

全球檢測

11 個端點

從全球 65+ 節點派發 Ping / TCP / UDP / HTTP / DNS / MTR 檢測 — 每次呼叫會回傳 UUID,接著自動輪詢 /report/{uuid} 取回結果。

快速 GET 捷徑

針對簡易檢測的現成 URL — 不支援區域指定或 Live 模式(這些請用上方的 POST)。

報告

3 個端點

取回先前派發檢測的 JSON 報告或已渲染的狀態圖。