Riferimento per sviluppatori

Lookup MX inverso (deprecato)

Consulta la documentazione API di Lookup MX inverso (deprecato), i parametri delle richieste, i campi delle risposte, gli esempi di codice e la gestione degli errori per le integrazioni DomScan.

Lookup MX inverso (deprecato)

Deprecato: questo endpoint cerca solo nomi host esatti in un indice best effort di sette giorni, alimentato da precedenti query /v1/dns/all. Ogni host MX conserva al massimo 10,000 voci recenti. L’API valuta il numero di voci indicato da limit prima di restituire, per impostazione predefinita, una riga per dominio radice. Non è un dataset esteso a tutta Internet.

GET /v1/reverse/mx

Parametri di query

Parametro	Tipo	Descrizione
mx obbligatorio	string	Nome host esatto del mailserver da verificare nella cache passiva deprecata di DomScan (alias: mailserver; ad esempio, "aspmx.l.google.com")
match facoltativo	string	Modalità di corrispondenza. È supportato solo exact.
include_apex_only facoltativo	boolean	Quando true (valore predefinito), restituisce una riga per dominio radice. Imposta false per conservare i nomi host osservati.
limit facoltativo	number	Numero massimo di voci recenti dell’indice da valutare prima della deduplicazione facoltativa per dominio radice. Valore predefinito: 100; massimo: 1000.

Casi d'uso

Controllare le osservazioni di DomScan nella cache per un host MX
Esaminare il contesto delle precedenti query API per l’infrastruttura email
Verificare se DomScan ha già visto domini corrispondenti
Usare come segnale legacy limitato, non come set di dati completo

Richiesta di esempio

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

Risposta di esempio

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

Campi di risposta

Campo	Tipo
`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