Productieklare endpoints zijn ontworpen voor 99,99% uptime en gedocumenteerde statusafhandeling.
Gebruikt door mensen bij geweldige bedrijven
Vertrouwenssignalen voordat je integreert
Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.
OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.
Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.
Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.
Wat deze API je helpt bouwen
Gebruik deze pagina als productiebriefing: endpoints, voorbeelden, responsstructuur en workflow-onderdelen om DomScan in je product te koppelen.
Integreer domeinchecks, DNS-intelligence, risicosignalen of verrijking in onboarding, zoeken en interne tools.
Vervang herhaalde handmatige lookups door geplande taken, alerts en reproduceerbare onderzoeksstappen.
Gebruik voorspelbare velden, gedocumenteerde statuscodes en kredietkosten in plaats van providerpagina’s te scrapen.
Voed agents, dashboards, SOAR-playbooks en CRMs via OpenAPI, SDK, Postman of MCP.
Integratieworkflow
Een eenvoudig pad van de eerste request naar herhaalbaar productiegebruik.
Stuur je API-sleutel met de gedocumenteerde header en houd requests consistent tussen services.
Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.
Gebruik statuscodes, kredietkosten en responsvelden om retries, logs en alerts te bouwen.
Developerkit
Ga vanaf deze pagina naar machineleesbare docs, requestcollecties, SDKs of agenttools.
Genereer clients of inspecteer elke request- en responsvorm.
Postman-collectieImporteer kant-en-klare requests voor handmatig testen en overdracht aan het team.
SDKs en CLIGebruik onderhouden pakketten en commandline-workflows in plaats van boilerplate te schrijven.
MCP-integratieStel domeinintelligence beschikbaar aan AI-agents en interne assistentworkflows.
Parameter- en responskaart
Bekijk inputs, outputvelden en statuscodes voordat je het endpoint in je client aansluit.
Parameter
Voorbeeldantwoord
HTTP-statuscodes
Endpoints
/v1/health
/v1/health/quick
Vertrouwenssignalen voordat je integreert
Transparante documentatie, geauthenticeerde requests en zichtbare betrouwbaarheidsdetails maken DomScan makkelijker te beoordelen voor livegang.
OpenAPI, Swagger, Postman, CLI, SDK en MCP-links zijn één klik verwijderd.
Geauthenticeerde endpoints gebruiken API-sleutels met duidelijke creditkosten voordat je ze aanroept.
Begin met 10.000 maandelijkse credits en upgrade pas wanneer het gebruik groeit.
Start met de curl- en HTTP-voorbeelden en map daarna de parameters naar je applicatiecode.
Belangrijkste functies
Controleer A, AAAA, MX, NS, TXT en andere DNS-records.
Valideer certificaten, controleer vervaldatum en uitgeverdetails.
Analyseer SPF-, DKIM- en DMARC-configuratie.
Controleer HSTS, CAA en andere beveiligingsconfiguraties.
Krijg een score van 0-100 met lettercijfer (A-F).
Duidelijke uitleg van problemen en hoe deze op te lossen.
Snelle DNS + HTTPS controle voor snelle monitoring.
Monitor meerdere domeinen in een enkel verzoek.
Voorbeeldverzoek
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/health?domain=cloudflare.com"
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",
"worker_version": "2.0.0"
}
}
Veelgestelde vragen
De gezondheidsscore (0-100) combineert DNS-configuratie, SSL-geldigheid, e-mailafleverbaarheid setup (SPF/DKIM/DMARC) en beveiligingsheaders. Hogere scores duiden op betere configuratie.
Het /health eindpunt voert uitgebreide controles uit inclusief SSL-validatie, e-mailrecords en beveiligingsheaders. Het /health/quick eindpunt controleert alleen DNS-resolutie en HTTPS-bereikbaarheid - veel sneller maar minder gedetailleerd.
Veel voorkomende verbeteringen zijn: SPF/DKIM/DMARC-records toevoegen voor e-mail, geldige SSL-certificaten verzekeren, HSTS-headers configureren en CAA DNS-records toevoegen.
Ja! Gebruik onze API om geautomatiseerde monitoring te bouwen. Controleer de domein gezondheid volgens een schema en waarschuw wanneer scores dalen of problemen worden gedetecteerd.
Gerelateerde hulpprogramma's en bronnen
HTTP-statuscodes
We documenteren de HTTP-statuscodes die je client moet afhandelen, zodat je succesvolle responses, authenticatieproblemen, credits, ratelimieten, ontbrekende gegevens en upstreamfouten kunt onderscheiden.
Aanvraag geslaagd
Ongeldige parameters
Niet genoeg credits om deze aanvraag uit te voeren.
Snelheidslimiet overschreden
Interne fout
Upstream RDAP-fout
De upstreamservice is niet beschikbaar of beperkt tijdelijk aanvragen.
De upstream-aanvraag heeft de tijdslimiet overschreden.
Controleer Domein Gezondheid Gratis