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

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

باستخدام 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": "string",
  "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": "string"
  }
}

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": "string"
}

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": "string",
    "tld": "com",
    "added_at": "2026-04-15T12:00:00Z",
    "last_scan_at": "2026-04-15T12:00:00Z",
    "scan_count": 1
  },
  "threats": {
    "baseline_count": 1,
    "current_count": 1,
    "new_since_baseline": 1,
    "new_threat_domains": [
      "example.com"
    ],
    "all_registered": [
      "string"
    ]
  },
  "alerts": {
    "email": "[email protected]",
    "webhook": "string"
  }
}

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": "string"
}

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": "string"
}