Аналитика доменов · Продукт DomScan

API Здоровье домена

Комплексная проверка здоровья домена, включая DNS, SSL, доступность веб-сайта и заголовки безопасности.

Что вы получите

Комплексная проверка здоровья домена, включая DNS, SSL, доступность веб-сайта и заголовки безопасности.

СинхронныйRESTMCPSDKИнтерактивный инструмент

Выберите этот продукт, если

Для кого этот продукт

Используйте отдельные проверки для одного решения или соберите расширенный профиль, когда важен контекст.

Выберите этот продукт, если

Выбирайте для краткой оценки состояния важных сигналов домена, DNS и безопасности.

Что вы получите

Комплексная проверка здоровья домена, включая DNS, SSL, доступность веб-сайта и заголовки безопасности.

Конечные точки

Перед интеграцией посмотрите, что принимает и возвращает каждый эндпоинт, а также его режимы и ограничения.

Кредиты и аутентификация

1-3 Требуется аутентификация. Точную стоимость, включая цены за отдельные элементы, смотрите в справочнике API.

Пример операции

Используйте документированные операции для сбора, оценки, обогащения, проверки, сравнения, защиты или мониторинга открытых данных.

GET /v1/health Кредиты: 3

Параметры запроса

Параметр Тип обязателен
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"
const response = await fetch("https://domscan.net/v1/health?domain=example.com&details=true", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/health?domain=example.com&details=true",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/health?domain=example.com&details=true", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/health?domain=example.com&details=true")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

Пример ответа

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

Коды состояния HTTP

  • 200 OK
  • 401 Не авторизован
  • 402 Требуется оплата
  • 429 Слишком много запросов

Часто задаваемые вопросы

Где найти справочник запросов и ответов для Здоровье домена?

В справочнике API для Здоровье домена описаны параметры, поля ответа, примеры, коды состояния и поддерживаемые режимы выполнения.

Как интерпретировать неизвестные или неполные результаты Здоровье домена?

Статус «неизвестно» или «частично» означает, что мы не смогли полностью подтвердить результат. Учитывайте статус, достоверность, актуальность и ограничения, когда действуете на основе результата.

Как рассчитывается цена Здоровье домена?

Цена зависит от проверки и выбранного режима. В справочнике API указаны текущая стоимость в кредитах, нужен ли API-ключ и цены за отдельные элементы.

Используется сотрудниками этих компаний

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeLLM Pulse