Référence Développeur

Recherche MX inversée (obsolète)

Consultez la documentation de l'API Recherche MX inversée (obsolète), ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

Recherche MX inversée (obsolète)

Obsolète : cet endpoint recherche uniquement les noms d’hôte exacts dans un index de sept jours à couverture non garantie, alimenté par de précédentes recherches /v1/dns/all. Chaque hôte MX conserve au maximum 10,000 entrées récentes. L’API évalue le nombre d’entrées indiqué par limit avant de renvoyer, par défaut, une ligne par domaine apex. Ce jeu de données ne couvre pas tout Internet.

GET /v1/reverse/mx

Paramètres de Requête

Paramètre	Type	Description
mx requis	string	Nom d’hôte exact du serveur mail à vérifier dans le cache passif DomScan obsolète (alias : mailserver ; par exemple, "aspmx.l.google.com")
match optionnel	string	Mode de correspondance. Seul exact est pris en charge.
include_apex_only optionnel	boolean	Avec true (valeur par défaut), une ligne est renvoyée par domaine apex. Utilisez false pour conserver les noms d’hôte observés.
limit optionnel	number	Nombre maximal d’entrées récentes de l’index à évaluer avant la déduplication facultative par domaine apex. Par défaut : 100 ; maximum : 1000.

Cas d'utilisation

Vérifier les observations MX en cache de DomScan
Examiner le contexte antérieur de l’infrastructure mail
Confirmer si DomScan a déjà vu des domaines correspondants
Utiliser comme signal hérité limité, pas comme jeu complet

Exemple de Requête

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

Exemple de Réponse

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

Champs de Réponse

Champ	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