개발자 참고자료
역방향 MX 조회(사용 중단)
역방향 MX 조회(사용 중단) API 문서에서 요청 매개변수, 응답 필드, 코드 예제, DomScan 통합을 위한 오류 처리를 확인하세요.
역방향 MX 조회(사용 중단)
사용 중단: 이 엔드포인트는 이전 /v1/dns/all 조회로만 채워지는 7일 베스트 에포트 인덱스에서 호스트명 정확히 일치하는 결과만 검색합니다. MX 호스트당 최근 항목을 최대 10,000개까지 유지합니다. API는 limit 항목을 평가한 뒤 기본적으로 apex 도메인당 한 행을 반환합니다. 인터넷 전체 데이터셋이 아닙니다.
GET
/v1/reverse/mx
쿼리 매개변수
| 매개변수 | 유형 | 설명 |
|---|---|---|
| mx 필수 | string | 사용 중단된 DomScan 패시브 캐시에서 확인할 정확한 메일 서버 호스트명(별칭: mailserver, 예: "aspmx.l.google.com") |
| match 선택 사항 | string | 일치 모드입니다. exact만 지원합니다. |
| include_apex_only 선택 사항 | boolean | true(기본값)이면 apex 도메인당 한 행을 반환합니다. 관측된 호스트명을 유지하려면 false로 설정하세요. |
| limit 선택 사항 | number | 선택적인 apex 중복 제거 전에 평가할 최근 인덱스 항목의 최대 수입니다. 기본값: 100, 최댓값: 1000. |
사용 사례
- MX 호스트에 관한 DomScan의 캐시된 관측 기록 확인
- 메일 인프라의 이전 API 조회 문맥 검토
- DomScan이 일치하는 도메인을 전에 관측했는지 확인
- 전체 데이터 세트가 아닌 제한된 이전 신호로 사용
예제 요청
# 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"
예제 응답
{
"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"
}
}
응답 필드
| 필드 | 유형 |
|---|---|
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 |