开发者参考

反向 MX 查询(已弃用)

已弃用:此端点只在由先前 /v1/dns/all 查询填充的七天尽力而为索引中执行主机名精确匹配。每个 MX 主机最多保留最近 10,000 条记录。API 先评估 limit 条记录,再默认每个根域名返回一行。它不是全网数据集。

反向 MX 查询(已弃用)

已弃用:此端点只在由先前 /v1/dns/all 查询填充的七天尽力而为索引中执行主机名精确匹配。每个 MX 主机最多保留最近 10,000 条记录。API 先评估 limit 条记录,再默认每个根域名返回一行。它不是全网数据集。

GET /v1/reverse/mx

查询参数

参数类型说明
mx 必需 string 在已弃用的 DomScan 被动缓存中查询的精确邮件服务器主机名(别名:mailserver;例如:"aspmx.l.google.com")
match 可选 string 匹配模式。仅支持 exact。
include_apex_only 可选 boolean 设为 true(默认)时,每个根域名返回一行。设为 false 可保留观测到的主机名。
limit 可选 number 在可选的根域名去重之前,最多评估的最近索引条目数。默认:100,最大:1000。

使用场景

  • 检查 DomScan 对某个 MX 主机的缓存观测记录
  • 审查邮件基础设施的先前 API 查询上下文
  • 确认 DomScan 之前是否见过匹配域名
  • 仅作为有限的旧版信号,而非完整数据集

请求示例

# 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"

响应示例

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

响应字段

字段 类型
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