DNS・ネットワーク 3 エンドポイント 8 主な機能

DNSリゾルバー比較 API

CloudflareとGoogleを、それぞれ独立したDNS-over-HTTPSエンドポイントで問い合わせて応答を比較します。どちらもグローバルエニーキャストの再帰サービスです。結果はWorkerのリクエスト経路からこの2社が返した内容であり、すべてのネットワークや地域で見える内容ではありません。

カテゴリ DNS・ネットワーク
エンドポイント 3
主な機能 8
よくある質問 4

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

ライブ サービスステータス

統合前に、現在のサービス稼働状況と文書化されたエラー応答を確認してください。

OpenAPI API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

10,000 無料枠

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

この API で実装できること

このページを本番導入向けの概要として使えます。エンドポイント、例、レスポンス形状、DomScan を製品に組み込むためのワークフローをまとめています。

プロダクトワークフロー

ドメイン確認、DNS インテリジェンス、リスクシグナル、エンリッチメントをオンボーディング、検索、社内ツールに組み込めます。

アナリスト自動化

繰り返しの手動検索を、スケジュールジョブ、アラート、再現可能な調査手順に置き換えます。

クリーンな JSON データ

提供元ページをスクレイピングせず、予測可能なフィールド、文書化済みステータスコード、クレジットコストを使えます。

AI と運用ツール

OpenAPI、SDK、Postman、MCP を通じて、エージェント、ダッシュボード、SOAR プレイブック、CRM に接続できます。

統合ワークフロー

最初のリクエストから本番で繰り返し使える状態までのシンプルな流れです。

1
一度認証する

文書化されたヘッダーで API キーを送信し、サービス間で一貫したリクエストを保ちます。

2
例から問い合わせる

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

3
運用と監視

ステータスコード、クレジットコスト、レスポンスフィールドを使ってリトライ、ログ、アラートを構築します。

開発者キット

機械可読なドキュメント、リクエスト集、SDK、エージェント用ツールへすぐ移動できます。

パラメータとレスポンスのマップ

クライアントに接続する前に、入力、出力フィールド、ステータスコードを確認できます。

リクエストパラメータ

パラメータ

domaintypeexpecteddomains
レスポンスフィールド

レスポンス例

domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful
ステータス範囲

HTTP ステータスコード

200400401402429500502503504

エンドポイント

GET /v1/dns/propagation
クレジット: 2認証: 認証が必要です
domaintypeexpected
POST /v1/dns/propagation/bulk
クレジット: 2認証: 認証が必要です
domainstypeexpected
GET /v1/dns/servers
クレジット: 0認証: 認証が必要です

統合前に確認できる信頼シグナル

透明なドキュメント、認証済みリクエスト、見える信頼性情報により、本番投入前に DomScan を評価しやすくなります。

サービスステータス API アーティファクト

OpenAPI、Swagger、Postman、CLI、SDK、MCP のリンクにすぐアクセスできます。

API キー 保護されたアクセス

認証付きエンドポイントは API キーを使用し、呼び出し前に明確なクレジットコストを示します。

無料枠 無料でサインアップ

毎月 10,000 クレジットから始め、利用が増えたときだけアップグレードできます。

アクティブ リクエスト例

curl と HTTP サンプルから始め、パラメータをアプリケーションコードに対応付けます。

主な機能

2つの独立したリゾルバーサービス

CloudflareとGoogleを別々に問い合わせ、別プロバイダーへのフォールバックは行いません。

複数のレコードタイプ

A、AAAA、CNAME、MX、TXT、NS、SOAレコードを比較します。

比較パーセンテージ

同一回答の最大グループ、またはexpected指定時の完全一致数を割合で表示します。

リゾルバー間の収束

設定済みの2つのリゾルバーが同じ正規化済み回答セットを返したか確認します。

期待値との一致

任意の期待レコード値をパーセンテージの基準にできます。

観測TTL

各リゾルバーが返したTTLを確認します。値には現在のキャッシュ状態が反映される場合があります。

リクエスト経路の応答時間

地域別の遅延ではなく、Workerのリクエスト経路からの応答時間を測定します。

応答元の情報

プロバイダー、エニーキャストの範囲、DoHエンドポイント、公式ドキュメントを表示します。

リクエスト例

GET /v1/dns/propagation bash
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/dns/propagation?domain=example.com&type=A"

レスポンス例

200 OK json
{
  "domain": "example.com",
  "record_type": "A",
  "measurement_scope": "configured_recursive_resolvers",
  "percentage_basis": "resolver_convergence",
  "propagation_percentage": 100,
  "fully_propagated": true,
  "consistent": true,
  "unique_values": ["93.184.216.34"],
  "results": [
    {
      "server": {
        "name": "Cloudflare 1.1.1.1",
        "ip": "1.1.1.1",
        "provider": "Cloudflare",
        "location": "Global anycast",
        "country": "GLOBAL",
        "scope": "global-anycast",
        "doh_endpoint": "https://cloudflare-dns.com/dns-query"
      },
      "success": true,
      "records": ["93.184.216.34"],
      "ttl": 86400,
      "response_time_ms": 12
    },
    {
      "server": {
        "name": "Google Public DNS",
        "ip": "8.8.8.8",
        "provider": "Google",
        "location": "Global anycast",
        "country": "GLOBAL",
        "scope": "global-anycast",
        "doh_endpoint": "https://dns.google/resolve"
      },
      "success": true,
      "records": ["93.184.216.34"],
      "ttl": 86400,
      "response_time_ms": 15
    }
  ],
  "summary": {
    "total_servers": 2,
    "successful": 2,
    "failed": 0,
    "matching_expected": 0
  }
}

よくある質問

この比較では何を測定しますか?

expectedがない場合、同一回答の最大グループ数を設定済みの2つのリゾルバーで割った値です。expectedがある場合、完全一致数を2で割った値です。fully_propagatedは、両者が同じ回答に収束したか、両者がexpectedと一致したことだけを示します。

CloudflareとGoogleの回答が異なることがあるのはなぜですか?

再帰リゾルバーはそれぞれ別のキャッシュを持ちます。TTLの期限、キャッシュに保存された時点、権威DNS側の段階的な変更、負荷分散、DNSポリシー、意図的な応答の出し分けによって結果が異なる場合があります。不一致が必ずしもエラーを意味するわけではありません。

どのDNSサービスに問い合わせますか?

Cloudflare 1.1.1.1とGoogle Public DNSを、それぞれのJSON DoHエンドポイントで個別に問い合わせます。どちらもグローバルエニーキャストの再帰サービスであり、2つの地理的拠点ではありません。

DNS変更が世界全体に伝播したことを証明できますか?

できません。Workerのリクエスト経路から2つの公開再帰サービスを比較するだけです。より広い範囲を確認するには、権威DNSサーバーも直接問い合わせ、重要なネットワークや地域からテストしてください。

関連ツール&リソース

HTTP ステータスコード

正常な応答、認証の問題、クレジット不足、レート制限、データ未検出、上流サービス障害を判別できるよう、クライアントで処理すべきHTTPステータスコードを明記しています。

成功 200

リクエスト成功

不正なリクエスト 400

無効なパラメータ

未認証 401

APIキーまたはセッションが不足しているか無効です。

支払いが必要 402

このリクエストを実行するためのクレジットが不足しています。

リクエスト過多 429

レート制限を超過

サーバーエラー 500

内部エラー

不正なゲートウェイ 502

上流 RDAP エラー

サービス利用不可 503

上流サービスが利用できないか、一時的にレート制限しています。

ゲートウェイタイムアウト 504

上流の問い合わせがタイムアウトしました。

DNSリゾルバーの応答を比較