Referência para desenvolvedores

Consulta reversa de IP (obsoleta)

Explore a documentação da API de Consulta reversa de IP (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 IP (obsoleta)

Obsoleto: este endpoint pesquisa endereços IPv4 ou IPv6 válidos apenas em um índice de melhor esforço de sete dias, alimentado por consultas anteriores a /v1/dns/all. Cada IP 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/ip

Parâmetros de Consulta

Parâmetro	Tipo	Descrição
ip obrigatório	string	Endereço IPv4 ou IPv6 válido a ser verificado no índice passivo obsoleto do DomScan (por exemplo, "93.184.216.34" ou "2001:db8::1")
dedupe_apex 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 IP
Revisar apenas o contexto de consultas anteriores da API
Confirmar se o DomScan já observou domínios relacionados
Usar como sinal legado limitado, não como conjunto de dados completo

Pedido de Exemplo

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/ip?ip=93.184.216.34&limit=50"

Resposta de Exemplo

{
  "query": {
    "ip": "93.184.216.34",
    "asn": null,
    "expand": "none",
    "dedupe_apex": 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
  },
  "coverage_summary": {
    "source": "passive_dns",
    "cache_status": "passive_cache_only",
    "passive_index": true,
    "result_count": 0,
    "returned_count": 0,
    "apex_deduped_count": 0,
    "warning_count": 2,
    "warnings": ["passive_cache_only", "no_cached_matches"],
    "last_seen_span_days": null
  },
  "page": {
    "limit": 50,
    "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.ip`	string \| null
`query.asn`	integer \| null
`query.expand`	string
`query.dedupe_apex`	boolean
`deprecated`	boolean
`deprecation_notice`	string
`ip_context`	object
`ip_context.ip`	string
`ip_context.asn`	integer
`ip_context.asn_name`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].apex`	string
`results[].ips[]`	string[]
`results[].last_seen`	string \| null
`results[].reason`	object
`results[].reason.type`	string
`results[].reason.matched`	string
`results[].reason.source`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`coverage_summary`	object
`coverage_summary.source`	string
`coverage_summary.cache_status`	string
`coverage_summary.passive_index`	boolean
`coverage_summary.result_count`	integer
`coverage_summary.returned_count`	integer
`coverage_summary.apex_deduped_count`	integer
`coverage_summary.warning_count`	integer
`coverage_summary.warnings[]`	string[]
`coverage_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