API de comparação de resolvedores e verificação de cache DNS

Categoria DNS e rede

Pontos finais 3

Principais Recursos 8

Perguntas frequentes 4

Usado por pessoas em empresas incríveis

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Ao vivo Status do serviço

Consulte o estado do serviço ao vivo e as respostas de falha documentadas antes de fazer a integração.

OpenAPI Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

10,000 Cota gratuita

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

O que esta API ajuda você a lançar

Use esta página como briefing de produção: endpoints, exemplos, formato da resposta e peças de workflow para conectar o DomScan ao seu produto.

Workflows de produto

Incorpore checagens de domínio, inteligência DNS, sinais de risco ou enriquecimento em onboarding, busca e ferramentas internas.

Automação de analistas

Substitua consultas manuais repetidas por jobs agendados, alertas e etapas de investigação reproduzíveis.

Dados JSON limpos

Use campos previsíveis, códigos de status documentados e custos em créditos em vez de raspar páginas de fornecedores.

IA e operações

Alimente agentes, dashboards, playbooks SOAR e CRMs via OpenAPI, SDK, Postman ou MCP.

Fluxo de integração

Um caminho simples da primeira requisição ao uso repetível em produção.

Autentique uma vez

Envie sua chave API com o cabeçalho documentado e mantenha requisições consistentes entre serviços.

Consulte com exemplos

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Opere e monitore

Use códigos de status, custos em créditos e campos de resposta para criar retentativas, logs e alertas.

Kit de desenvolvedor

Saia desta página para docs legíveis por máquina, coleções de requisições, SDKs ou ferramentas para agentes.

Esquema OpenAPI

Gere clientes ou inspecione cada formato de requisição e resposta.

Coleção Postman

Importe requisições prontas para testes manuais e repasse ao time.

SDKs e CLI

Use pacotes mantidos e fluxos de linha de comando em vez de escrever boilerplate.

Integração MCP

Exponha inteligência de domínios para agentes de IA e assistentes internos.

Mapa de parâmetros e resposta

Revise entradas, campos de saída e códigos de status antes de ligar o endpoint ao seu cliente.

Parâmetros da requisição

Parâmetro

domaintypeexpecteddomains

Campos da resposta

Resposta de Exemplo

domainrecord_typemeasurement_scopepercentage_basispropagation_percentagefully_propagatedconsistentunique_valuesresultssummarysummary.total_serverssummary.successful

Cobertura de status

Códigos de Estado HTTP

200400401402429

Pontos finais

GET /v1/dns/propagation

Créditos: 2Autenticação: Autenticação necessária

domaintypeexpected

POST /v1/dns/propagation/bulk

Créditos: 2/itemAutenticação: Autenticação necessária

domainstypeexpected

GET /v1/dns/servers

Créditos: 0Autenticação: Autenticação necessária

Sinais de confiança antes da integração

Documentação transparente, solicitações autenticadas e detalhes visíveis de confiabilidade facilitam avaliar o DomScan antes de publicar.

Status do serviço Artefatos da API

OpenAPI, Swagger, Postman, CLI, SDK e links MCP ficam a um clique.

Chaves API Acesso protegido

Endpoints autenticados usam chaves API com custos de créditos claros antes da chamada.

Cota gratuita Cadastre-se Gratuitamente

Comece com 10.000 créditos mensais e faça upgrade só quando o uso crescer.

Ativo Pedido de Exemplo

Comece pelos exemplos curl e HTTP, depois mapeie os parâmetros no código da sua aplicação.

Principais Recursos

Dois provedores independentes

Consulta Cloudflare e Google separadamente, sem usar um provedor como alternativa para o outro.

Múltiplos Tipos de Registro

Verifique registros A, AAAA, CNAME, MX, TXT, NS e SOA.

Percentual de comparação

Mostra o maior grupo de respostas iguais ou, quando expected é informado, as correspondências exatas com esse valor.

Convergência dos resolvedores

Mostra se os dois resolvedores configurados devolveram o mesmo conjunto canônico de respostas.

Correspondência com o valor esperado

Permite usar um valor de registro esperado e exato como base do percentual.

TTLs observados

Mostra o TTL devolvido por cada resolvedor, que pode refletir o estado atual do cache.

Tempos no caminho da requisição

Mede o tempo de resposta pelo caminho da requisição, não a latência de regiões geográficas.

Origem dos resolvedores

Mostra o provedor, o escopo anycast, o endpoint DoH e a documentação de cada resolvedor.

Pedido de Exemplo

GET /v1/dns/propagation bash

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

Resposta de Exemplo

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
  }
}

Perguntas frequentes

O que esta comparação de resolvedores mede?

Sem expected, o percentual é o maior grupo de respostas idênticas dividido pelos dois resolvedores configurados. Com expected, é o número de correspondências exatas dividido pelos dois resolvedores. Falhas continuam no denominador. fully_propagated significa apenas que os dois convergem ou que ambos retornam expected.

Por que Cloudflare e Google podem retornar respostas diferentes?

Resolvedores recursivos mantêm caches separados. As diferenças podem vir do vencimento do TTL, do momento em que cada cache foi atualizado, de mudanças graduais nos servidores autoritativos, de balanceamento de carga, de políticas DNS ou de variações intencionais nas respostas. Uma divergência não indica erro automaticamente.

Quais serviços DNS são consultados?

A API consulta de forma independente o Cloudflare 1.1.1.1 e o Google Public DNS pelos endpoints JSON DoH de cada provedor. Ambos são provedores recursivos com anycast global, não dois locais geográficos.

Esta comparação prova que uma mudança de DNS se propagou no mundo todo?

Não. A API compara dois provedores recursivos públicos a partir do caminho da requisição. Para obter evidências mais amplas, consulte também os servidores autoritativos diretamente e teste as redes ou regiões importantes para você.

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP

Documentamos os códigos de estado HTTP que deves tratar para distinguir respostas bem-sucedidas, problemas de autenticação, créditos, limites de taxa, dados em falta e falhas do serviço a montante.

OK 200

Pedido bem-sucedido

Pedido inválido 400

Parâmetros inválidos

Não autorizado 401

Chave de API ou sessão em falta ou inválida.

Pagamento necessário 402

Não tens créditos suficientes para executar este pedido.

Demasiados pedidos 429

Limite de taxa excedido

Comparar respostas de resolvedores DNS

Começar Gratuitamente Ver documentação

Suporte

API de Comparação de resolvedores DNS

Sinais de confiança antes da integração

O que esta API ajuda você a lançar

Fluxo de integração

Kit de desenvolvedor

Mapa de parâmetros e resposta

Pontos finais

Sinais de confiança antes da integração

Principais Recursos

Pedido de Exemplo

Resposta de Exemplo

Perguntas frequentes

Ferramentas e Recursos Relacionados

Códigos de Estado HTTP