Entwickler-Referenz

Reverse-MX-Lookup (veraltet)

Entdecken Sie die API-Dokumentation zu Reverse-MX-Lookup (veraltet), Anfrageparameter, Antwortfelder, Codebeispiele und Fehlerbehandlung für DomScan-Integrationen.

Reverse-MX-Lookup (veraltet)

Veraltet: Dieser Endpunkt sucht exakte Hostnamen nur in einem siebentägigen Best-Effort-Index, der durch frühere /v1/dns/all-Abfragen befüllt wird. Pro MX-Host werden höchstens 10,000 der neuesten Einträge gespeichert. Die API wertet die mit limit angegebene Zahl von Einträgen aus, bevor standardmäßig eine Zeile pro Apex-Domain zurückgegeben wird. Dies ist kein internetweiter Datensatz.

GET /v1/reverse/mx

Abfrageparameter

Parameter	Typ	Beschreibung
mx erforderlich	string	Exakter Hostname des Mailservers, der im veralteten passiven DomScan-Cache geprüft werden soll (Alias: mailserver; z. B. "aspmx.l.google.com")
match optional	string	Abgleichmodus. Nur exact wird unterstützt.
include_apex_only optional	boolean	Bei true (Standard) wird eine Zeile pro Apex-Domain zurückgegeben. Mit false bleiben beobachtete Hostnamen erhalten.
limit optional	number	Höchstzahl der neuesten Indexeinträge, die vor der optionalen Apex-Deduplizierung ausgewertet werden. Standard: 100, Maximum: 1000.

Anwendungsfälle

Zwischengespeicherte DomScan-Beobachtungen für einen MX-Host prüfen
Früheren Kontext zur Mail-Infrastruktur prüfen
Prüfen, ob DomScan passende Domains bereits gesehen hat
Als begrenztes Altsignal verwenden, nicht als vollständigen Datensatz

Beispielanfrage

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

Beispielantwort

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

Antwort-Felder

Feld	Typ
`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