ذكاء النطاقات · منتج DomScan

API الخاص بـ صحة المجال

فحص صحة شامل للمجال بما في ذلك DNS و SSL وقابلية الوصول إلى موقع الويب ورؤوس الأمان.

ما الذي تحصل عليه

فحص صحة شامل للمجال بما في ذلك DNS و SSL وقابلية الوصول إلى موقع الويب ورؤوس الأمان.

متزامنRESTMCPSDKأداة تفاعلية

اختر هذا المنتج عندما

لمن صُمم هذا المنتج

استخدم فحوصات مركّزة لقرار واحد، أو أنشئ ملفًا أوسع عندما يكون السياق مهمًا.

اختر هذا المنتج عندما

اختره لعرض موجز للصحة عبر إشارات النطاق وDNS والأمان المهمة.

ما الذي تحصل عليه

فحص صحة شامل للمجال بما في ذلك DNS و SSL وقابلية الوصول إلى موقع الويب ورؤوس الأمان.

نقاط النهاية

راجع العمليات والمدخلات والمخرجات وأنماط التنفيذ وحدود الاستجابة المدعومة قبل التكامل.

GET /v1/health عرض مرجع API
GET /v1/health/quick عرض مرجع API

الوحدات والمصادقة

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 الخاص بـ صحة المجال لمراجعة المعاملات وحقول الاستجابة والأمثلة ورموز الحالة وأنماط التشغيل المدعومة.

كيف أفسر النتائج غير المعروفة أو غير المكتملة من صحة المجال؟

تعني النتائج غير المعروفة أو الجزئية أن الأدلة المطلوبة لم تُحسم بالكامل. احتفظ بحالة النتيجة ومستوى الثقة والحداثة والحدود عند اتخاذ القرارات اللاحقة.

كيف يتم احتساب سعر صحة المجال؟

تختلف الأسعار حسب العملية ونمط التنفيذ. راجع مرجع نقطة النهاية لمعرفة التكلفة الحالية ومتطلبات المصادقة وقواعد التسعير لكل عنصر.

يستخدمه أشخاص في شركات مميزة

InstantOutseerMongoDBRespondentSage Expense ManagementInstantlyD.R. HortonWhatConvertsAdobeMotionElementsLLM Pulse