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 ですぐ使えます — リージョン指定やライブモードはありません(その場合は上の POST を使用)。

レポート

3 エンドポイント

送信済みチェックの JSON レポートやステータス画像を取得します。