Les endpoints prêts pour la production sont conçus pour 99,99% de disponibilité et une gestion documentée des statuts.
Utilisé par les gens des meilleures entreprises
Signaux de confiance avant intégration
Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.
OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Ce que cette API vous aide à livrer
Utilisez cette page comme brief de production : endpoints, exemples, structure de réponse et éléments de workflow pour intégrer DomScan à votre produit.
Intégrez vérifications de domaines, intelligence DNS, signaux de risque ou enrichissement dans l’onboarding, la recherche et les outils internes.
Remplacez les recherches manuelles répétées par des tâches planifiées, des alertes et des étapes d’enquête reproductibles.
Utilisez des champs prévisibles, des codes d’état documentés et des coûts en crédits au lieu de scraper des pages fournisseur.
Alimentez agents, tableaux de bord, playbooks SOAR et CRMs via OpenAPI, SDK, Postman ou MCP.
Flux d’intégration
Un parcours simple de la première requête à un usage répétable en production.
Envoyez votre clé API avec l’en-tête documenté et gardez des requêtes cohérentes entre services.
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Utilisez codes d’état, coûts en crédits et champs de réponse pour construire retries, logs et alertes.
Kit développeur
Passez de cette page aux docs lisibles par machine, collections de requêtes, SDKs ou outils d’agents.
Générez des clients ou inspectez chaque forme de requête et de réponse.
Collection PostmanImportez des requêtes prêtes pour les tests manuels et le transfert à l’équipe.
SDKs et CLIUtilisez des packages maintenus et des workflows en ligne de commande au lieu d’écrire du boilerplate.
Intégration MCPExposez l’intelligence de domaines aux agents IA et aux assistants internes.
Carte des paramètres et réponses
Parcourez les entrées, champs de sortie et codes d’état avant de connecter l’endpoint à votre client.
Paramètre
Exemple de Réponse
Codes de Statut HTTP
Points d'accès
/v1/health
/v1/health/quick
Signaux de confiance avant intégration
Une documentation transparente, des requêtes authentifiées et des détails de fiabilité visibles facilitent l’évaluation de DomScan avant mise en production.
OpenAPI, Swagger, Postman, CLI, SDK et liens MCP sont accessibles en un clic.
Les endpoints authentifiés utilisent des clés API avec des coûts en crédits clairs avant l’appel.
Commencez avec 10 000 crédits mensuels et passez à l’offre supérieure seulement quand l’usage augmente.
Commencez par les exemples curl et HTTP, puis mappez les paramètres dans le code de votre application.
Fonctionnalités clés
Verifiez les enregistrements A, AAAA, MX, NS, TXT et autres enregistrements DNS.
Validez les certificats, verifiez l'expiration et les details de l'emetteur.
Analysez la configuration SPF, DKIM et DMARC.
Verifiez HSTS, CAA et autres configurations de securite.
Obtenez un score de 0 a 100 avec une note (A-F).
Explications claires des problemes et comment les resoudre.
Verification rapide DNS + HTTPS pour une surveillance rapide.
Surveillez plusieurs domaines en une seule requete.
Exemple de Requête
curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/health?domain=cloudflare.com"
Exemple de Réponse
{
"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"
}
}
Foire aux questions
Le score de sante (0-100) combine la configuration DNS, la validite SSL, la configuration de delivrabilite des e-mails (SPF/DKIM/DMARC) et les en-tetes de securite. Des scores plus eleves indiquent une meilleure configuration.
Le point de terminaison /health effectue des verifications completes incluant la validation SSL, les enregistrements e-mail et les en-tetes de securite. Le point de terminaison /health/quick verifie uniquement la resolution DNS et l'accessibilite HTTPS - beaucoup plus rapide mais moins detaille.
Les ameliorations courantes incluent : l'ajout d'enregistrements SPF/DKIM/DMARC pour les e-mails, la garantie de certificats SSL valides, la configuration des en-tetes HSTS et l'ajout d'enregistrements DNS CAA.
Oui ! Utilisez notre API pour creer une surveillance automatisee. Verifiez la sante du domaine selon un calendrier et recevez des alertes lorsque les scores baissent ou que des problemes sont detectes.
Outils et Ressources Connexes
Codes de Statut HTTP
Nous documentons les codes d'état HTTP que votre client doit gérer afin de distinguer les réponses réussies, les problèmes d'authentification, les crédits, les limites de débit, les données introuvables et les erreurs en amont.
Requête réussie
Paramètres invalides
Crédits insuffisants pour exécuter cette requête.
Limite de débit dépassée
Erreur interne
Erreur RDAP en amont
Le service amont est indisponible ou limite temporairement les requêtes.
La requête amont a expiré.
Verifiez la sante du domaine gratuitement