Riferimento per sviluppatori

Lookup IP inverso (deprecato)

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

Lookup IP inverso (deprecato)

Deprecato: questo endpoint cerca indirizzi IPv4 o IPv6 validi solo in un indice best effort di sette giorni, alimentato da precedenti query /v1/dns/all. Ogni IP 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/ip

Parametri di query

Parametro	Tipo	Descrizione
ip obbligatorio	string	Indirizzo IPv4 o IPv6 valido da verificare nell’indice passivo deprecato di DomScan (ad esempio, "93.184.216.34" o "2001:db8::1")
dedupe_apex 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 IP
Esaminare solo il contesto delle precedenti query API
Verificare se DomScan ha già visto domini correlati
Usare come segnale legacy limitato, non come set di dati completo

Richiesta di esempio

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/reverse/ip?ip=93.184.216.34&limit=50"

Risposta di esempio

{
  "query": {
    "ip": "93.184.216.34",
    "asn": null,
    "expand": "none",
    "dedupe_apex": 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
  },
  "coverage_summary": {
    "source": "passive_dns",
    "cache_status": "passive_cache_only",
    "passive_index": true,
    "result_count": 0,
    "returned_count": 0,
    "apex_deduped_count": 0,
    "warning_count": 2,
    "warnings": ["passive_cache_only", "no_cached_matches"],
    "last_seen_span_days": null
  },
  "page": {
    "limit": 50,
    "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.ip`	string \| null
`query.asn`	integer \| null
`query.expand`	string
`query.dedupe_apex`	boolean
`deprecated`	boolean
`deprecation_notice`	string
`ip_context`	object
`ip_context.ip`	string
`ip_context.asn`	integer
`ip_context.asn_name`	string
`results[]`	object[]
`results[]`	object
`results[].domain`	string
`results[].apex`	string
`results[].ips[]`	string[]
`results[].last_seen`	string \| null
`results[].reason`	object
`results[].reason.type`	string
`results[].reason.matched`	string
`results[].reason.source`	string
`summary`	object
`summary.total_found`	integer
`summary.returned`	integer
`coverage_summary`	object
`coverage_summary.source`	string
`coverage_summary.cache_status`	string
`coverage_summary.passive_index`	boolean
`coverage_summary.result_count`	integer
`coverage_summary.returned_count`	integer
`coverage_summary.apex_deduped_count`	integer
`coverage_summary.warning_count`	integer
`coverage_summary.warnings[]`	string[]
`coverage_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