개발자 참고자료

역방향 IP 조회(사용 중단)

역방향 IP 조회(사용 중단) API 문서에서 요청 매개변수, 응답 필드, 코드 예제, DomScan 통합을 위한 오류 처리를 확인하세요.

역방향 IP 조회(사용 중단)

사용 중단: 이 엔드포인트는 이전 /v1/dns/all 조회로만 채워지는 7일 베스트 에포트 인덱스에서 유효한 IPv4 또는 IPv6 주소만 검색합니다. IP당 최근 항목을 최대 10,000개까지 유지합니다. API는 limit 항목을 평가한 뒤 기본적으로 apex 도메인당 한 행을 반환합니다. 인터넷 전체 데이터셋이 아닙니다.

GET /v1/reverse/ip

쿼리 매개변수

매개변수	유형	설명
ip 필수	string	사용 중단된 DomScan 패시브 인덱스에서 확인할 유효한 IPv4 또는 IPv6 주소(예: "93.184.216.34" 또는 "2001:db8::1")
dedupe_apex 선택 사항	boolean	true(기본값)이면 apex 도메인당 한 행을 반환합니다. 관측된 호스트명을 유지하려면 false로 설정하세요.
limit 선택 사항	number	선택적인 apex 중복 제거 전에 평가할 최근 인덱스 항목의 최대 수입니다. 기본값: 100, 최댓값: 1000.

사용 사례

IP에 관한 DomScan의 캐시된 관측 기록 확인
이전 API 조회 문맥만 검토
DomScan이 관련 도메인을 전에 관측했는지 확인
전체 데이터 세트가 아닌 제한된 이전 신호로 사용

예제 요청

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

예제 응답

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

응답 필드

필드	유형
`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