Domeinengezondheid API-referentie

Wat je krijgt

Uitgebreide gezondheidscontrole voor een domein met inbegrip van DNS, SSL, bereikbaarheid van websites en beveiligingsheaders.

SynchroonRESTMCPSDKInteractieve tool

Kies dit product wanneer

Voor wie is dit?

Gebruik gerichte controles voor één beslissing of stel een breder profiel samen wanneer context belangrijk is.

Kies dit product wanneer

Kies dit voor een beknopt gezondheidsbeeld van belangrijke domein-, DNS- en beveiligingssignalen.

Wat je krijgt

Uitgebreide gezondheidscontrole voor een domein met inbegrip van DNS, SSL, bereikbaarheid van websites en beveiligingsheaders.

Endpoints

Bekijk vóór de integratie de ondersteunde bewerkingen, invoer, uitvoer, uitvoeringsmodi en responslimieten.

GET /v1/health API-referentie bekijken

GET /v1/health/quick API-referentie bekijken

Credits en authenticatie

1-3 Authenticatie vereist. Bekijk de bewerkingsreferentie voor de exacte kosten en eventuele prijs per item.

Voorbeeldbewerking

Gebruik gedocumenteerde bewerkingen om openbaar bewijs te verzamelen, te beoordelen, te verrijken, te verifiëren, te vergelijken, te beschermen of te monitoren.

GET /v1/health

Queryparameters

Parameter	Type	vereist
domain	string	vereist
details	boolean Standaard `true`	optioneel

Antwoordvelden

Veld	Type
`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

Voorbeeldverzoek

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/health?domain=example.com&details=true"

Voorbeeldantwoord

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

Beperkingen en grenzen van het bewijs

Onbekend betekent dat het gevraagde feit niet kon worden vastgesteld op basis van het beschikbare bewijs.

Gedeeltelijk betekent dat sommige gevraagde items of onderdelen zijn voltooid en andere niet.

In cache geeft aan dat opgeslagen bewijs is gebruikt. Bekijk de metadata voor actualiteit wanneer die beschikbaar is.

Bewijs kan in de loop van de tijd veranderen. Gebruik tijdstempels en velden voor actualiteit wanneer die beschikbaar zijn.

Beoordeeld op 2026-08-22

Gerelateerde producten

Veelgestelde vragen

Waar vind ik de request- en response-referentie voor Domeinengezondheid?

Gebruik de API-referentie voor Domeinengezondheid om parameters, responsevelden, voorbeelden, statuscodes en ondersteunde uitvoeringsmodi te bekijken.

Hoe moet ik onbekende of onvolledige resultaten van Domeinengezondheid interpreteren?

Onbekende of gedeeltelijke resultaten betekenen dat het gevraagde bewijs niet volledig kon worden vastgesteld. Houd de resultaatstatus, betrouwbaarheid, actualiteit en beperkingen bij in vervolgbeslissingen.

Hoe wordt Domeinengezondheid geprijsd?

De prijs hangt af van de bewerking en uitvoeringsmodus. Bekijk de endpointreferentie voor de actuele creditkosten, authenticatievereiste en regels per item.

Wat je krijgt

Kies dit product wanneer

Voor wie is dit?

Kies dit product wanneer

Wat je krijgt

Endpoints

Credits en authenticatie

Voorbeeldbewerking

Queryparameters

Antwoordvelden

Voorbeeldverzoek

Voorbeeldantwoord

Beperkingen en grenzen van het bewijs

Gerelateerde producten

Domeinprofiel

Domeinreputatie

DNS-veiligheidsanalyse

Veelgestelde vragen