대상 사용자
단일 결정을 위해 집중형 검사를 사용하거나 컨텍스트가 중요할 때 더 넓은 프로필을 구성하세요.
제공 내용
DNS, SSL, 웹사이트 도달성 및 보안 헤더를 포함한 도메인의 종합 건강 상태 확인입니다.
동기RESTMCPSDK대화형 도구
다음과 같은 경우 이 제품을 선택하세요
다음과 같은 경우 이 제품을 선택하세요
중요한 도메인, DNS 및 보안 신호를 아우르는 간결한 상태 보기가 필요할 때 선택하세요.
제공 내용
DNS, SSL, 웹사이트 도달성 및 보안 헤더를 포함한 도메인의 종합 건강 상태 확인입니다.
엔드포인트
통합하기 전에 지원되는 작업, 입력, 출력, 실행 모드 및 응답 제한을 확인하세요.
크레딧 및 인증
1-3 인증 필요. 정확한 비용과 항목별 요금은 작업 레퍼런스에서 확인하세요.
작업 예시
문서화된 작업을 사용해 공개 증거를 수집, 평가, 보강, 검증, 비교, 보호 또는 모니터링하세요.
GET
/v1/health
쿼리 매개변수
| 매개변수 | 유형 | 필수 |
|---|---|---|
| domain | string | 필수 |
| details |
boolean
기본값
true
|
선택 사항 |
응답 필드
| 필드 | 유형 |
|---|---|
domain |
string |
health_score |
integer |
grade |
string |
checks |
object |
checks.dns_configured |
boolean |
checks.ssl_valid |
boolean |
checks.email_deliverable |
boolean |
checks.blacklist_status |
string |
checks.age_years |
integer | null |
checks.registration_stable |
boolean |
checks.dnssec_enabled |
boolean |
enriched |
object |
enriched.tls |
object |
enriched.tls.grade |
string |
enriched.tls.protocol |
string | null |
enriched.tls.cipher |
string | null |
enriched.tls.chain_valid |
boolean |
enriched.tls.days_to_expiry |
integer |
enriched.tls.hostname_match |
boolean | null |
enriched.tls.ocsp_stapling |
boolean |
enriched.tls.grade_reasons[] |
string[] |
enriched.http_versions |
object |
enriched.http_versions.http1_1 |
boolean |
enriched.http_versions.http2 |
boolean |
enriched.http_versions.http3 |
boolean |
enriched.http_versions.alt_svc |
string | null |
enriched.http_versions.http3_advertised |
boolean |
enriched.http_versions.alt_svc_protocols[] |
string[] |
enriched.http_versions.curl_http3_supported |
boolean |
enriched.http_versions.h2_alpn_accepted |
string | null |
enriched.http_versions.h3_alpn_accepted |
string | null |
enriched.hsts |
object |
enriched.hsts.reachable |
boolean |
enriched.hsts.final_url |
string | null |
enriched.hsts.status_code |
integer | null |
enriched.hsts.header_present |
boolean |
enriched.hsts.hsts_header |
string | null |
enriched.hsts.max_age |
integer | null |
enriched.hsts.include_subdomains |
boolean | null |
enriched.hsts.preload_directive |
boolean | null |
enriched.hsts.preload_eligible |
boolean |
enriched.hsts.preload_status |
string | null |
enriched.hsts.preloaded_domain |
string | null |
enriched.hsts.preload_bulk |
boolean | null |
enriched.hsts.issues[] |
string[] |
enriched.hsts.errors[] |
string[] |
enriched.smtp |
object |
enriched.smtp.host |
string |
enriched.smtp.port |
integer |
enriched.smtp.reachable |
boolean |
enriched.smtp.tls_mode |
string |
enriched.smtp.tls_negotiated |
boolean |
enriched.smtp.tls_protocol |
string |
enriched.smtp.tls_cipher |
string |
enriched.smtp.starttls_offered |
boolean | null |
enriched.smtp.banner |
string |
enriched.smtp.error |
string |
enriched.smtp.fcrdns |
object |
enriched.smtp.fcrdns.addresses[] |
string[] |
enriched.smtp.fcrdns.ptr_hostnames[] |
string[] |
enriched.smtp.fcrdns.all_forward_confirmed |
boolean |
enriched.smtp.fcrdns.confirmed_addresses[] |
string[] |
enriched.smtp.fcrdns.unconfirmed_addresses[] |
string[] |
warnings[] |
string[] |
recommendations[] |
string[] |
component_summary |
object |
component_summary.score |
integer |
component_summary.grade |
string |
component_summary.check_count |
integer |
component_summary.passed_count |
integer |
component_summary.failed_count |
integer |
component_summary.warning_count |
integer |
component_summary.recommendation_count |
integer |
component_summary.confidence |
string |
component_summary.dns_ok |
boolean |
component_summary.https_ok |
boolean |
component_summary.email_ok |
boolean |
component_summary.blacklist_status |
string |
component_summary.dnssec_enabled |
boolean |
component_summary.enriched_section_count |
integer |
component_summary.enriched_sections[] |
string[] |
details |
object |
health_checks[] |
object[] |
health_checks[] |
object |
health_checks[].category |
string |
health_checks[].name |
string |
health_checks[].passed |
boolean |
health_checks[].score |
integer |
health_checks[].weight |
integer |
health_checks[].details |
string | null |
checked_at |
string |
meta |
object |
meta.check_duration_ms |
integer |
meta.served_by |
string |
예제 요청
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/health?domain=example.com&details=true"예제 응답
{
"domain": "cloudflare.com",
"health_score": 94,
"grade": "A",
"checks": {
"dns_configured": true,
"ssl_valid": true,
"email_deliverable": true,
"blacklist_status": "clean",
"age_years": 15,
"registration_stable": true,
"dnssec_enabled": true
},
"enriched": {
"tls": {
"grade": "A+",
"protocol": "TLSv1.3",
"cipher": "TLS_AES_256_GCM_SHA384",
"chain_valid": true,
"days_to_expiry": 72,
"hostname_match": true,
"ocsp_stapling": true,
"grade_reasons": [
"TLS 1.3 enabled",
"Valid certificate chain"
]
},
"http_versions": {
"http1_1": true,
"http2": true,
"http3": true,
"alt_svc": "h3=\":443\"; ma=86400",
"http3_advertised": true,
"alt_svc_protocols": [
"h3"
],
"curl_http3_supported": true,
"h2_alpn_accepted": "h2",
"h3_alpn_accepted": "h3"
},
"hsts": {
"reachable": true,
"final_url": "https://cloudflare.com/",
"status_code": 200,
"header_present": true,
"hsts_header": "max-age=31536000; includeSubDomains",
"max_age": 31536000,
"include_subdomains": true,
"preload_directive": false,
"preload_eligible": true,
"preload_status": "preloaded",
"preloaded_domain": "cloudflare.com",
"preload_bulk": false,
"issues": [
"missing preload directive"
],
"errors": []
}
},
"warnings": [],
"recommendations": [
"Publish the HSTS preload directive if you want preload-list eligibility."
],
"checked_at": "2026-04-18T21:00:00Z",
"details": {
"dns": {
"has_a_record": true,
"has_aaaa_record": true,
"has_nameservers": true,
"has_mx_record": true,
"nameservers": [
"ns3.cloudflare.com",
"ns5.cloudflare.com"
],
"mx_records": [
"route1.mx.cloudflare.net"
],
"a_records": [
"104.16.132.229",
"104.16.133.229"
],
"aaaa_records": [
"2606:4700::6810:84e5",
"2606:4700::6810:85e5"
]
},
"ssl": {
"https_works": true,
"certificate_valid": true,
"days_until_expiry": 72,
"issuer": "Google Trust Services"
},
"email": {
"has_mx": true,
"has_spf": true,
"has_dmarc": true,
"has_dkim_selector": true,
"spf_record": "v=spf1 include:_spf.google.com ~all",
"dmarc_policy": "reject",
"mx_hosts": [
"route1.mx.cloudflare.net"
]
},
"security": {
"dnssec_enabled": true,
"has_caa_record": true,
"caa_issuers": [
"digicert.com",
"letsencrypt.org"
],
"http_to_https_redirect": true,
"has_security_txt": true,
"security_txt_fields": [
"Contact",
"Expires",
"Preferred-Languages"
],
"security_headers": {
"has_hsts": true,
"hsts_max_age": 31536000,
"has_csp": true,
"has_x_frame_options": true,
"has_x_content_type_options": true,
"has_referrer_policy": true,
"has_permissions_policy": true,
"score": 92
}
},
"age": {
"registration_date": "2010-07-06T00:00:00Z",
"expiration_date": "2030-07-06T00:00:00Z",
"last_updated": "2025-07-06T00:00:00Z",
"age_days": 5766,
"age_years": 15,
"days_until_expiry": 1540,
"registrar": "Cloudflare Registrar"
},
"blacklist": {
"clean": true,
"status": "clean",
"listed_on": [],
"checked_lists": [
"spamhaus",
"surbl"
],
"domain_listed_on": [],
"ip_listed_on": [],
"check_type": "mixed"
}
},
"health_checks": [
{
"category": "dns",
"name": "Authoritative DNS records present",
"passed": true,
"score": 100,
"weight": 15
}
],
"meta": {
"check_duration_ms": 248,
"served_by": "pop=MAD country=ES"
}
}제한 및 증거 범위
알 수 없음은 사용 가능한 증거로 요청된 사실을 판단할 수 없었다는 뜻입니다.
부분적이라는 것은 요청된 항목이나 구성 요소 중 일부는 완료되고 나머지는 완료되지 않았다는 뜻입니다.
캐시됨은 저장된 증거가 사용되었다는 뜻입니다. 제공되는 경우 최신성 메타데이터를 확인하세요.
증거는 시간에 따라 바뀔 수 있습니다. 제공되는 경우 타임스탬프와 최신성 필드를 사용하세요.
검토일: 2026-08-22
자주 묻는 질문
도메인 건강 상태 요청 및 응답 레퍼런스는 어디에서 확인할 수 있나요?
도메인 건강 상태 API 레퍼런스에서 매개변수, 응답 필드, 예시, 상태 코드 및 지원되는 작업 모드를 확인하세요.
도메인 건강 상태의 알 수 없거나 불완전한 결과는 어떻게 해석해야 하나요?
알 수 없거나 부분적인 결과는 요청된 증거를 완전히 판단할 수 없었다는 뜻입니다. 후속 의사결정에서 결과 상태, 신뢰도, 최신성 및 제한을 유지하세요.
도메인 건강 상태의 요금은 어떻게 책정되나요?
요금은 작업과 실행 모드에 따라 달라집니다. 현재 크레딧 비용, 인증 요구 사항 및 항목별 규칙은 엔드포인트 레퍼런스에서 확인하세요.
