DomScan | API de Saúde do Domínio

O que você recebe

Verificação abrangente de saúde para um domínio incluindo DNS, SSL, acessibilidade do website e cabeçalhos de segurança.

SíncronoRESTMCPSDKFerramenta interativa

Escolha este produto quando

Para quem é

Use verificações focadas para uma decisão ou monte um perfil mais amplo quando o contexto for importante.

Escolha este produto quando

Escolha para uma visão concisa de saúde sobre sinais importantes de domínio, DNS e segurança.

O que você recebe

Verificação abrangente de saúde para um domínio incluindo DNS, SSL, acessibilidade do website e cabeçalhos de segurança.

Endpoints

Revise as operações, entradas, saídas, modos de execução e limites de resposta compatíveis antes da integração.

GET /v1/health Ver referência da API

GET /v1/health/quick Ver referência da API

Créditos e autenticação

1-3 Autenticação obrigatória. Consulte a referência da operação para ver o custo exato e qualquer preço por item.

Operação de exemplo

Use operações documentadas para coletar, avaliar, enriquecer, verificar, comparar, proteger ou monitorar evidências públicas.

GET /v1/health

Parâmetros de Consulta

Parâmetro	Tipo	obrigatório
domain	string	obrigatório
details	boolean Padrão `true`	opcional

Campos de Resposta

Campo	Tipo
`domain`	string
`health_score`	integer
`grade`	string
`checks`	object
`checks.dns_configured`	boolean
`checks.ssl_valid`	boolean
`checks.email_deliverable`	boolean
`checks.blacklist_status`	string
`checks.age_years`	integer \| null
`checks.registration_stable`	boolean
`checks.dnssec_enabled`	boolean
`enriched`	object
`enriched.tls`	object
`enriched.tls.grade`	string
`enriched.tls.protocol`	string \| null
`enriched.tls.cipher`	string \| null
`enriched.tls.chain_valid`	boolean
`enriched.tls.days_to_expiry`	integer
`enriched.tls.hostname_match`	boolean \| null
`enriched.tls.ocsp_stapling`	boolean
`enriched.tls.grade_reasons[]`	string[]
`enriched.http_versions`	object
`enriched.http_versions.http1_1`	boolean
`enriched.http_versions.http2`	boolean
`enriched.http_versions.http3`	boolean
`enriched.http_versions.alt_svc`	string \| null
`enriched.http_versions.http3_advertised`	boolean
`enriched.http_versions.alt_svc_protocols[]`	string[]
`enriched.http_versions.curl_http3_supported`	boolean
`enriched.http_versions.h2_alpn_accepted`	string \| null
`enriched.http_versions.h3_alpn_accepted`	string \| null
`enriched.hsts`	object
`enriched.hsts.reachable`	boolean
`enriched.hsts.final_url`	string \| null
`enriched.hsts.status_code`	integer \| null
`enriched.hsts.header_present`	boolean
`enriched.hsts.hsts_header`	string \| null
`enriched.hsts.max_age`	integer \| null
`enriched.hsts.include_subdomains`	boolean \| null
`enriched.hsts.preload_directive`	boolean \| null
`enriched.hsts.preload_eligible`	boolean
`enriched.hsts.preload_status`	string \| null
`enriched.hsts.preloaded_domain`	string \| null
`enriched.hsts.preload_bulk`	boolean \| null
`enriched.hsts.issues[]`	string[]
`enriched.hsts.errors[]`	string[]
`enriched.smtp`	object
`enriched.smtp.host`	string
`enriched.smtp.port`	integer
`enriched.smtp.reachable`	boolean
`enriched.smtp.tls_mode`	string
`enriched.smtp.tls_negotiated`	boolean
`enriched.smtp.tls_protocol`	string
`enriched.smtp.tls_cipher`	string
`enriched.smtp.starttls_offered`	boolean \| null
`enriched.smtp.banner`	string
`enriched.smtp.error`	string
`enriched.smtp.fcrdns`	object
`enriched.smtp.fcrdns.addresses[]`	string[]
`enriched.smtp.fcrdns.ptr_hostnames[]`	string[]
`enriched.smtp.fcrdns.all_forward_confirmed`	boolean
`enriched.smtp.fcrdns.confirmed_addresses[]`	string[]
`enriched.smtp.fcrdns.unconfirmed_addresses[]`	string[]
`warnings[]`	string[]
`recommendations[]`	string[]
`component_summary`	object
`component_summary.score`	integer
`component_summary.grade`	string
`component_summary.check_count`	integer
`component_summary.passed_count`	integer
`component_summary.failed_count`	integer
`component_summary.warning_count`	integer
`component_summary.recommendation_count`	integer
`component_summary.confidence`	string
`component_summary.dns_ok`	boolean
`component_summary.https_ok`	boolean
`component_summary.email_ok`	boolean
`component_summary.blacklist_status`	string
`component_summary.dnssec_enabled`	boolean
`component_summary.enriched_section_count`	integer
`component_summary.enriched_sections[]`	string[]
`details`	object
`health_checks[]`	object[]
`health_checks[]`	object
`health_checks[].category`	string
`health_checks[].name`	string
`health_checks[].passed`	boolean
`health_checks[].score`	integer
`health_checks[].weight`	integer
`health_checks[].details`	string \| null
`checked_at`	string
`meta`	object
`meta.check_duration_ms`	integer
`meta.served_by`	string

Pedido de Exemplo

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/health?domain=example.com&details=true"

Resposta de Exemplo

{
  "domain": "cloudflare.com",
  "health_score": 94,
  "grade": "A",
  "checks": {
    "dns_configured": true,
    "ssl_valid": true,
    "email_deliverable": true,
    "blacklist_status": "clean",
    "age_years": 15,
    "registration_stable": true,
    "dnssec_enabled": true
  },
  "enriched": {
    "tls": {
      "grade": "A+",
      "protocol": "TLSv1.3",
      "cipher": "TLS_AES_256_GCM_SHA384",
      "chain_valid": true,
      "days_to_expiry": 72,
      "hostname_match": true,
      "ocsp_stapling": true,
      "grade_reasons": [
        "TLS 1.3 enabled",
        "Valid certificate chain"
      ]
    },
    "http_versions": {
      "http1_1": true,
      "http2": true,
      "http3": true,
      "alt_svc": "h3=\":443\"; ma=86400",
      "http3_advertised": true,
      "alt_svc_protocols": [
        "h3"
      ],
      "curl_http3_supported": true,
      "h2_alpn_accepted": "h2",
      "h3_alpn_accepted": "h3"
    },
    "hsts": {
      "reachable": true,
      "final_url": "https://cloudflare.com/",
      "status_code": 200,
      "header_present": true,
      "hsts_header": "max-age=31536000; includeSubDomains",
      "max_age": 31536000,
      "include_subdomains": true,
      "preload_directive": false,
      "preload_eligible": true,
      "preload_status": "preloaded",
      "preloaded_domain": "cloudflare.com",
      "preload_bulk": false,
      "issues": [
        "missing preload directive"
      ],
      "errors": []
    }
  },
  "warnings": [],
  "recommendations": [
    "Publish the HSTS preload directive if you want preload-list eligibility."
  ],
  "checked_at": "2026-04-18T21:00:00Z",
  "details": {
    "dns": {
      "has_a_record": true,
      "has_aaaa_record": true,
      "has_nameservers": true,
      "has_mx_record": true,
      "nameservers": [
        "ns3.cloudflare.com",
        "ns5.cloudflare.com"
      ],
      "mx_records": [
        "route1.mx.cloudflare.net"
      ],
      "a_records": [
        "104.16.132.229",
        "104.16.133.229"
      ],
      "aaaa_records": [
        "2606:4700::6810:84e5",
        "2606:4700::6810:85e5"
      ]
    },
    "ssl": {
      "https_works": true,
      "certificate_valid": true,
      "days_until_expiry": 72,
      "issuer": "Google Trust Services"
    },
    "email": {
      "has_mx": true,
      "has_spf": true,
      "has_dmarc": true,
      "has_dkim_selector": true,
      "spf_record": "v=spf1 include:_spf.google.com ~all",
      "dmarc_policy": "reject",
      "mx_hosts": [
        "route1.mx.cloudflare.net"
      ]
    },
    "security": {
      "dnssec_enabled": true,
      "has_caa_record": true,
      "caa_issuers": [
        "digicert.com",
        "letsencrypt.org"
      ],
      "http_to_https_redirect": true,
      "has_security_txt": true,
      "security_txt_fields": [
        "Contact",
        "Expires",
        "Preferred-Languages"
      ],
      "security_headers": {
        "has_hsts": true,
        "hsts_max_age": 31536000,
        "has_csp": true,
        "has_x_frame_options": true,
        "has_x_content_type_options": true,
        "has_referrer_policy": true,
        "has_permissions_policy": true,
        "score": 92
      }
    },
    "age": {
      "registration_date": "2010-07-06T00:00:00Z",
      "expiration_date": "2030-07-06T00:00:00Z",
      "last_updated": "2025-07-06T00:00:00Z",
      "age_days": 5766,
      "age_years": 15,
      "days_until_expiry": 1540,
      "registrar": "Cloudflare Registrar"
    },
    "blacklist": {
      "clean": true,
      "status": "clean",
      "listed_on": [],
      "checked_lists": [
        "spamhaus",
        "surbl"
      ],
      "domain_listed_on": [],
      "ip_listed_on": [],
      "check_type": "mixed"
    }
  },
  "health_checks": [
    {
      "category": "dns",
      "name": "Authoritative DNS records present",
      "passed": true,
      "score": 100,
      "weight": 15
    }
  ],
  "meta": {
    "check_duration_ms": 248,
    "served_by": "pop=MAD country=ES"
  }
}

Limites e fronteiras das evidências

Desconhecido significa que o fato solicitado não pôde ser determinado com as evidências disponíveis.

Parcial significa que alguns itens ou componentes solicitados foram concluídos, mas outros não.

Em cache indica que evidências armazenadas foram usadas. Consulte os metadados de atualização quando disponíveis.

As evidências podem mudar com o tempo. Use os carimbos de data e os campos de atualização quando disponíveis.

Revisado em 2026-08-22

Produtos relacionados

Perguntas frequentes

Onde encontro a referência de solicitação e resposta de Saúde do Domínio?

Use a referência da API de Saúde do Domínio para revisar parâmetros, campos de resposta, exemplos, códigos de status e modos de operação compatíveis.

Como devo interpretar resultados desconhecidos ou incompletos de Saúde do Domínio?

Resultados desconhecidos ou parciais significam que as evidências solicitadas não puderam ser totalmente determinadas. Mantenha o estado do resultado, a confiança, a atualização e as limitações nas decisões seguintes.

Como Saúde do Domínio é cobrado?

O preço depende da operação e do modo de execução. Consulte a referência do endpoint para ver o custo atual em créditos, o requisito de autenticação e as regras por item.

O que você recebe

Escolha este produto quando

Para quem é

Escolha este produto quando

O que você recebe

Endpoints

Créditos e autenticação

Operação de exemplo

Parâmetros de Consulta

Campos de Resposta

Pedido de Exemplo

Resposta de Exemplo

Limites e fronteiras das evidências

Produtos relacionados

Perfil de Domínio

Reputação de Domínio

Análise de Segurança de DNS

Perguntas frequentes