Referência para desenvolvedores

Consulta reversa de MX (obsoleta)

Explore a documentação da API de Consulta reversa de MX (obsoleta), os parâmetros de solicitação, os campos de resposta, os exemplos de código e o tratamento de erros para integrações com o DomScan.

Consulta reversa de MX (obsoleta)

Obsoleto: este endpoint pesquisa apenas nomes de host exatos em um índice de melhor esforço de sete dias, alimentado por consultas anteriores a /v1/dns/all. Cada host MX mantém no máximo 10,000 entradas recentes. A API avalia o número de entradas indicado por limit antes de retornar, por padrão, uma linha por domínio raiz. Não é um conjunto de dados de toda a Internet.

GET /v1/reverse/mx

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
mx obrigatório	string	Nome de host exato do servidor de e-mail a ser verificado no cache passivo obsoleto do DomScan (alias: mailserver; por exemplo, "aspmx.l.google.com")
match opcional	string	Modo de correspondência. Somente exact é aceito.
include_apex_only opcional	boolean	Quando true (padrão), retorna uma linha por domínio raiz. Use false para preservar os nomes de host observados.
limit opcional	number	Número máximo de entradas recentes do índice a serem avaliadas antes da deduplicação opcional por domínio raiz. Padrão: 100; máximo: 1000.

Casos de Utilização

Consultar observações em cache do DomScan para um host MX
Revisar o contexto de consultas anteriores sobre infraestrutura de e-mail
Confirmar se o DomScan já observou domínios correspondentes
Usar como sinal legado limitado, não como conjunto de dados completo

Pedido de Exemplo

# Deprecated limited cache lookup for prior DomScan DNS observations
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/mx?mx=aspmx.l.google.com&limit=100"

# Deprecated limited cache lookup for another MX hostname
curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/mx?mx=outlook.protection.outlook.com"

Resposta de Exemplo

{
  "query": {
    "mx": "aspmx.l.google.com",
    "match": "exact",
    "include_apex_only": true
  },
  "deprecated": true,
  "deprecation_notice": "This endpoint is deprecated. It only searches a best-effort seven-day passive index populated by prior /v1/dns/all lookups and capped at 10,000 recent entries per key. It is not an internet-wide reverse DNS dataset.",
  "results": [],
  "summary": {
    "total_found": 0,
    "returned": 0
  },
  "freshness_summary": {
    "source": "passive_dns",
    "cache_status": "passive_cache_only",
    "result_count": 0,
    "returned_count": 0,
    "apex_domain_count": 0,
    "apex_deduped_count": 0,
    "warnings": ["passive_cache_only", "no_cached_matches"]
  },
  "page": {
    "limit": 100,
    "next_cursor": null
  },
  "meta": {
    "source": "passive_dns",
    "note": "Best-effort seven-day index populated only by prior /v1/dns/all lookups"
  }
}

Campos de Resposta

Campo	Tipo
`query`	object
`query.mx`	string
`query.match`	string
`query.include_apex_only`	boolean
`deprecated`	boolean
`deprecation_notice`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].apex`	string
`results[].mx`	string
`results[].all_mx[]`	object[]
`results[].all_mx[]`	object
`results[].all_mx[].host`	string
`results[].all_mx[].priority`	integer \| null
`results[].last_seen`	string \| null
`results[].reason`	object
`results[].reason.type`	string
`results[].reason.matched`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`freshness_summary`	object
`freshness_summary.source`	string
`freshness_summary.cache_status`	string
`freshness_summary.result_count`	integer
`freshness_summary.returned_count`	integer
`freshness_summary.apex_domain_count`	integer
`freshness_summary.apex_deduped_count`	integer
`freshness_summary.warning_count`	integer
`freshness_summary.warnings[]`	string[]
`freshness_summary.last_seen_span_days`	integer \| null
`page`	object
`page.limit`	integer
`page.next_cursor`	string \| null
`meta`	object
`meta.generated_at`	string
`meta.source`	string
`meta.query_time_ms`	integer
`meta.note`	string
`cache`	object
`cache.hit`	boolean \| null
`cache.age_s`	integer \| null
`cache.ttl_s`	integer \| null
`cache.key`	string \| null