开发者参考
反向 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 |