مرجع المطورين

وصفة تقييم التهديد

باستخدام DomScan API، تحليل شامل لتهديدات الاختطاف بالأخطاء الإملائية والعلامة التجارية لفرق الأمان.

وصفة تقييم التهديد

تحليل شامل لتهديدات الاختطاف بالأخطاء الإملائية والعلامة التجارية لفرق الأمان.

GET /v1/recipes/threat-assessment

معاملات الاستعلام

المعامل	النوع	Description
domain مطلوب	string	نطاق العلامة التجارية لتقييم التهديدات له
analyze_threats اختياري	boolean القيم المسموحة `1trueyes0falseno` الافتراضي `true`	تشغيل التحليل العميق لكل تهديد. عند التعطيل، يتم حساب المتغيرات المسجلة ولكن تُرجع قائمة threats فارغة.
max_threats اختياري	integer الافتراضي `10`	التهديدات المسجلة للتحليل العميق، من 1 إلى 50. يتم تحليل النطاقات الأكثر خطورة أولاً.
include_evidence اختياري	boolean القيم المسموحة `1trueyes0falseno` الافتراضي `true`	إرجاع ownership_evidence على كل تهديد محلل. عند التعطيل، يتم إرجاع ownership_assessment فقط.

تتضمن الاستجابة

كشف نطاق الاختطاف بالأخطاء الإملائية
كشف هجوم homoglyph
تحديد التهديد النشط
درجة المخاطرة والأولويات
توصيات الإصلاح

حقول الرد

الحقل	النوع
`success`	boolean
`data`	object
`data.domain`	string
`data.summary`	object
`data.summary.risk_level`	string
`data.summary.overall_score`	number
`data.summary.total_variants_generated`	number
`data.summary.variants_registered`	number
`data.summary.active_threats`	number
`data.summary.suspicious_activity`	number
`data.protection_score`	object
`data.protection_score.score`	number
`data.protection_score.grade`	string
`data.protection_score.vulnerabilities[]`	object[]
`data.protection_score.vulnerabilities[]`	object
`data.protection_score.vulnerabilities[].category`	string
`data.protection_score.vulnerabilities[].count`	number
`data.protection_score.vulnerabilities[].risk`	string
`data.protection_score.vulnerabilities[].description`	string
`data.threats[]`	object[]
`data.threats[]`	object
`data.threats[].domain`	string
`data.threats[].threat_type`	string
`data.threats[].risk_level`	string
`data.threats[].registered`	boolean
`data.threats[].registration`	object
`data.threats[].registration.registrar`	string
`data.threats[].registration.created_date`	string
`data.threats[].registration.privacy_protected`	boolean
`data.threats[].infrastructure`	object
`data.threats[].infrastructure.ip`	string
`data.threats[].infrastructure.hosting_provider`	string
`data.threats[].infrastructure.country`	string
`data.threats[].indicators`	object
`data.threats[].indicators.has_mx_records`	boolean
`data.threats[].indicators.has_website`	boolean
`data.threats[].indicators.ssl_valid`	boolean
`data.threats[].indicators.reputation_flags[]`	string[]
`data.threats[].recommendation`	string
`data.recommendations[]`	string[]
`data.action_items[]`	object[]
`data.action_items[]`	object
`data.action_items[].priority`	string
`data.action_items[].category`	string
`data.action_items[].action`	string
`data.action_items[].details`	string
`data.action_items[].estimated_impact`	string
`meta`	object
`meta.recipe_name`	string
`meta.credits_used`	number
`meta.credits_saved`	number
`meta.duration_ms`	number
`meta.components_called[]`	string[]
`meta.cached_components[]`	string[]
`meta.timestamp`	string
`errors[]`	array

مثال الرد

{
  "success": true,
  "data": {
    "domain": "brand.com",
    "summary": {
      "risk_level": "high",
      "overall_score": 61,
      "total_variants_generated": 120,
      "variants_registered": 14,
      "active_threats": 3,
      "suspicious_activity": 2
    },
    "protection_score": {
      "score": 73,
      "grade": "B",
      "vulnerabilities": [
        {
          "category": "homoglyph",
          "count": 3,
          "risk": "high",
          "description": "Lookalike Unicode variants are registered."
        }
      ]
    },
    "threats": [
      {
        "domain": "brancd.com",
        "threat_type": "typosquatting",
        "risk_level": "high",
        "registered": true,
        "registration": {
          "registrar": "Example Registrar",
          "created_date": "2026-01-10",
          "privacy_protected": true
        },
        "infrastructure": {
          "ip": "198.51.100.21",
          "hosting_provider": "Example Hosting",
          "country": "US"
        },
        "indicators": {
          "has_mx_records": true,
          "has_website": true,
          "ssl_valid": false,
          "reputation_flags": [
            "recent_registration",
            "parked"
          ]
        },
        "recommendation": "Investigate hosting and submit abuse report."
      }
    ],
    "recommendations": [
      "Monitor newly registered typo variants.",
      "Escalate active lookalike websites to brand protection."
    ],
    "action_items": [
      {
        "priority": "critical",
        "category": "brand-protection",
        "action": "Investigate high-risk typo domains",
        "details": "Three active websites are impersonating the brand.",
        "estimated_impact": "Reduce phishing exposure"
      }
    ]
  },
  "meta": {
    "recipe_name": "threat-assessment",
    "credits_used": 18,
    "credits_saved": 22,
    "duration_ms": 934,
    "components_called": [
      "typosquatting",
      "availability",
      "whois",
      "health",
      "reputation"
    ],
    "cached_components": [
      "availability"
    ],
    "timestamp": "2026-04-15T10:02:00Z"
  },
  "errors": []
}