Ontwikkelaarsreferentie

Omgekeerde MX-lookup (verouderd)

Bekijk de API-documentatie voor Omgekeerde MX-lookup (verouderd), aanvraagparameters, responsvelden, codevoorbeelden en foutafhandeling voor DomScan-integraties.

Omgekeerde MX-lookup (verouderd)

Verouderd: dit endpoint zoekt alleen exacte hostnamen in een zevendaagse best-effortindex die wordt opgebouwd uit eerdere /v1/dns/all-lookups. Per MX-host worden maximaal 10,000 recente vermeldingen bewaard. De API beoordeelt het door limit opgegeven aantal vermeldingen voordat standaard één rij per hoofddomein wordt teruggegeven. Dit is geen internetbrede dataset.

GET /v1/reverse/mx

Queryparameters

Parameter	Type	Beschrijving
mx vereist	string	Exacte hostnaam van de mailserver om te controleren in de verouderde passieve cache van DomScan (alias: mailserver; bijvoorbeeld "aspmx.l.google.com")
match optioneel	string	Overeenkomstmodus. Alleen exact wordt ondersteund.
include_apex_only optioneel	boolean	Als true (standaard) wordt één rij per hoofddomein teruggegeven. Stel false in om waargenomen hostnamen te behouden.
limit optioneel	number	Maximaal aantal recente indexvermeldingen dat vóór de optionele deduplicatie per hoofddomein wordt beoordeeld. Standaard: 100, maximaal: 1000.

Gebruikssituaties

Gecachte DomScan-waarnemingen voor een MX-host controleren
De context van eerdere API-lookups voor mailinfrastructuur beoordelen
Controleren of DomScan overeenkomende domeinen eerder heeft gezien
Gebruiken als beperkt verouderd signaal, niet als volledige gegevensset

Voorbeeldverzoek

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

Voorbeeldantwoord

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

Antwoordvelden

Veld	Type
`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