DNS 리졸버 비교 API 레퍼런스

예제 요청

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

const response = await fetch("https://domscan.net/v1/dns/propagation?domain=example.com&type=A&expected=192.0.2.1", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);

import os
import requests

response = requests.get(
    "https://domscan.net/v1/dns/propagation?domain=example.com&type=A&expected=192.0.2.1",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())

package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/dns/propagation?domain=example.com&type=A&expected=192.0.2.1", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}

require "json"
require "net/http"

uri = URI("https://domscan.net/v1/dns/propagation?domain=example.com&type=A&expected=192.0.2.1")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

예제 응답

{
  "domain": "example.com",
  "record_type": "A",
  "expected_value": "192.0.2.10",
  "measurement_scope": "configured_recursive_resolvers",
  "percentage_basis": "expected_value_match",
  "propagation_percentage": 100,
  "fully_propagated": true,
  "consistent": true,
  "unique_values": [
    "192.0.2.10"
  ],
  "results": [
    {
      "server": {
        "name": "Cloudflare 1.1.1.1",
        "ip": "1.1.1.1",
        "location": "Global anycast",
        "country": "GLOBAL",
        "provider": "Cloudflare",
        "scope": "global-anycast",
        "doh_endpoint": "https://cloudflare-dns.com/dns-query",
        "documentation_url": "https://developers.cloudflare.com/1.1.1.1/encryption/dns-over-https/make-api-requests/dns-json/",
        "format": "dns-json"
      },
      "success": true,
      "records": [
        "192.0.2.10"
      ],
      "ttl": 300,
      "response_time_ms": 38
    },
    {
      "server": {
        "name": "Google Public DNS",
        "ip": "8.8.8.8",
        "location": "Global anycast",
        "country": "GLOBAL",
        "provider": "Google",
        "scope": "global-anycast",
        "doh_endpoint": "https://dns.google/resolve",
        "documentation_url": "https://developers.google.com/speed/public-dns/docs/doh/json",
        "format": "dns-json"
      },
      "success": true,
      "records": [
        "192.0.2.10"
      ],
      "ttl": 300,
      "response_time_ms": 52
    }
  ],
  "checked_at": "2026-10-09T10:15:30.000Z",
  "total_duration_ms": 61,
  "summary": {
    "total_servers": 2,
    "successful": 2,
    "failed": 0,
    "matching_expected": 2
  },
  "propagation_summary": {
    "measurement_scope": "configured_recursive_resolvers",
    "percentage_basis": "expected_value_match",
    "resolver_count": 2,
    "successful_count": 2,
    "failed_count": 0,
    "propagation_percentage": 100,
    "fully_propagated": true,
    "consistent": true,
    "unique_value_count": 1,
    "matching_expected_count": 2,
    "expected_value_present": true,
    "countries_checked": 1,
    "providers_checked": 2,
    "locations_checked": 1,
    "slowest_resolver": "Google Public DNS",
    "slowest_response_ms": 52,
    "fastest_response_ms": 38,
    "disagreement_count": 0,
    "confidence": "high"
  }
}

HTTP 상태 코드

• 200 성공
• 400 잘못된 요청
• 401 인증되지 않음
• 402 결제 필요
• 429 요청 과다