Geliştirici Referansı

Tehdit Değerlendirme Reçetesi

Alan adı analizi için DomScan API: Güvenlik ekipleri için kapsamlı typosquatting ve marka tehdidi analizi.

Tehdit Değerlendirme Reçetesi

Güvenlik ekipleri için kapsamlı typosquatting ve marka tehdidi analizi.

GET /v1/recipes/threat-assessment

Sorgu Parametreleri

Parametre	Tür	Açıklama
domain gerekli	string	Tehditleri değerlendirilecek marka domaini
analyze_threats isteğe bağlı	boolean İzin verilen değerler `1trueyes0falseno` Varsayılan `true`	Derin threat analizi çalıştırın. Devre dışı bırakıldığında, kayıtlı varyantlar yine de sayılır ancak threats listesi boş döner.
max_threats isteğe bağlı	integer Varsayılan `10`	Derinlemesine analiz edilecek kayıtlı tehditler, 1 ile 50 arasında. En yüksek riskli domain'ler önce analiz edilir.
include_evidence isteğe bağlı	boolean İzin verilen değerler `1trueyes0falseno` Varsayılan `true`	Her analiz edilen threat için ownership_evidence döndürün. Devre dışı bırakıldığında, yalnızca ownership_assessment döndürülür.

Yanıt İçeriği

Typosquatting domain tespiti
Homoglyph saldırısı tespiti
Etkin tehditlerin belirlenmesi
Risk puanlama ve önceliklendirme
Düzeltme önerileri

Yanıt Alanları

Alan	Tür
`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

Örnek Yanıt

{
  "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": []
}