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

مراقب العلامة التجارية

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

مراقب العلامة التجارية

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

GET /v1/brand-monitor

احصل على جميع العلامات التجارية المراقبة وحالة التهديد الحالية.

مثال الرد

{
                "brands": [
                {
                "domain": "mycompany.com",
                "added_at": "2024-03-01T12:00:00Z",
                "last_scan_at": "2024-03-14T08:30:00Z",
                "scan_count": 6,
                "registered_typos": 3,
                "new_threats_since_baseline": 1,
                "has_alerts": true
                }
                ],
                "total": 1,
                "updated_at": "2024-03-14T08:30:00Z"
                }

حقول الرد

الحقل	النوع
`brands[]`	object[]
`brands[]`	object
`brands[].domain`	string
`brands[].added_at`	string
`brands[].last_scan_at`	string \| null
`brands[].scan_count`	integer
`brands[].registered_typos`	integer
`brands[].new_threats_since_baseline`	integer
`brands[].has_alerts`	boolean
`brands[].scan_status`	string
`total`	integer
`updated_at`	string

POST /v1/brand-monitor

إنشاء مراقب عملة تجارية جديد.

نص الطلب

{
                "domain": "mycompany.com",
                "alert_email": "[email protected]"
                }

حقول الرد

الحقل	النوع
`success`	boolean
`message`	string
`brand`	object
`brand.domain`	string
`brand.baseline_threats`	integer
`brand.scan_status`	string
`initial_scan`	object \| null

مثال الرد

{
  "success": true,
  "message": "Request completed",
  "brand": {
    "domain": "example.com",
    "baseline_threats": 1,
    "scan_status": "pending"
  },
  "initial_scan": {}
}

POST /v1/brand-monitor/scan?domain=mycompany.com

تشغيل فحص فوري لمراقب العلامة التجارية.

حقول الرد

الحقل	النوع
`success`	boolean
`scan`	object \| null
`alert`	object
`alert.level`	string
`alert.message`	string

مثال الرد

{
  "success": true,
  "scan": {},
  "alert": {
    "level": "medium",
    "message": "Request completed"
  }
}

DELETE /v1/brand-monitor

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

المعامل	النوع	مطلوب
domain	string	مطلوب

حقول الرد

الحقل	النوع
`success`	boolean
`message`	string

طلب مثال

curl -X DELETE "https://domscan.net/v1/brand-monitor?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

مثال الرد

{
  "success": true,
  "message": "Request completed"
}

GET /v1/brand-monitor/status

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

المعامل	النوع	مطلوب
domain	string	مطلوب

حقول الرد

الحقل	النوع
`brand`	object
`brand.domain`	string
`brand.name`	string
`brand.tld`	string
`brand.added_at`	string
`brand.last_scan_at`	string \| null
`brand.scan_count`	integer
`threats`	object
`threats.baseline_count`	integer
`threats.current_count`	integer
`threats.new_since_baseline`	integer
`threats.new_threat_domains[]`	string[]
`threats.all_registered[]`	string[]
`alerts`	object
`alerts.email`	string \| null
`alerts.webhook`	string \| null

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/brand-monitor/status?domain=example.com"

مثال الرد

{
  "brand": {
    "domain": "example.com",
    "name": "example",
    "tld": "com",
    "added_at": "2026-08-27T12:00:00Z",
    "last_scan_at": "2026-08-27T12:00:00Z",
    "scan_count": 1
  },
  "threats": {
    "baseline_count": 1,
    "current_count": 1,
    "new_since_baseline": 1,
    "new_threat_domains": [
      "example.com"
    ],
    "all_registered": [
      "example"
    ]
  },
  "alerts": {
    "email": "[email protected]",
    "webhook": "example"
  }
}

POST /v1/brand-monitor/reset-baseline

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

المعامل	النوع	مطلوب
domain	string	مطلوب

حقول الرد

الحقل	النوع
`success`	boolean
`message`	string

طلب مثال

curl -X POST "https://domscan.net/v1/brand-monitor/reset-baseline?domain=example.com" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{}'

مثال الرد

{
  "success": true,
  "message": "Request completed"
}

PUT /v1/brand-monitor/alerts

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

المعامل	النوع	مطلوب
domain	string	مطلوب
alert_email	string \| null	اختياري
alert_webhook	string \| null	اختياري

حقول الرد

الحقل	النوع
`success`	boolean
`message`	string

طلب مثال

curl -X PUT "https://domscan.net/v1/brand-monitor/alerts" \
  -H "Content-Type: application/json" \
  -H "X-API-Key: $DOMSCAN_API_KEY" \
  -d '{
  "domain": "example.com",
  "alert_email": "[email protected]",
  "alert_webhook": "https://example.com"
}'

مثال الرد

{
  "success": true,
  "message": "Request completed"
}