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 ですぐ使えます — リージョン指定やライブモードはありません（その場合は上の 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 レポートやステータス画像を取得します。