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

بحث عنوان MAC

استكشف توثيق API الخاص بـ بحث عنوان MAC، بما في ذلك معلمات الطلب وحقول الاستجابة وأمثلة الشفرة ومعالجة الأخطاء لتكاملات DomScan.

بحث عنوان MAC

تحديد مصنعي أجهزة الشبكة من عناوين MAC (بحث OUI). يدعم كلاً من عناوين EUI-48 و EUI-64 بأي صيغة شائعة. يعيد اسم البائع والمنظمة والعنوان والدول وتصنيف نوع الجهاز. مفيد لجرد الشبكة والتدقيق الأمني وتحديد الجهاز.

GET /v1/mac

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

المعامل	النوع	Description
mac مطلوب	string	عنوان MAC بأي صيغة: `44:38:39:FF:EF:57` ((القولون)) `44-38-39-FF-EF-57` ((الشرطة)) `443839FFEF57` ((عادي))

حقول الرد

الحقل	Description
`mac`	عنوان MAC معياري
`type`	نوع العنوان (eui-48 أو eui-64)
`oui`	معرّف فريد في المنظمة (أول 3 بايتات)
`device_id`	معرّف وحدة التحكم في واجهة الشبكة (آخر 3 بايتات)
`flags`	multicast, locally_administered, broadcast
`vendor.name`	اسم الشركة المصنعة/البائع
`vendor.organization`	اسم المنظمة الكامل
`vendor.country`	دولة التسجيل
`vendor.device_type`	فئة الجهاز (إن أمكن)

حالات الاستخدام

جرد أجهزة الشبكة
تحديد الأجهزة الوهمية على الشبكة
إدارة الأصول والتدقيق
تصنيف أجهزة IoT

طلب مثال

curl -H "X-API-Key: your-api-key" "https://domscan.net/v1/mac?mac=44:38:39:ff:ef:57"

import requests

domscan = requests.Session()
domscan.headers.update({"X-API-Key": "your-api-key"})

response = domscan.get(
    "https://domscan.net/v1/mac",
    params={"mac": "44:38:39:ff:ef:57"}
)
data = response.json()

if data['vendor']['found']:
    print(f"Vendor: {data['vendor']['name']}")
    print(f"Country: {data['vendor']['country']}")
else:
    print("Unknown vendor (not in IEEE registry)")

مثال الرد

{
  "mac": "44:38:39:FF:EF:57",
  "input": "44:38:39:ff:ef:57",
  "type": "eui-48",
  "oui": "44:38:39",
  "device_id": "FF:EF:57",
  "flags": {
    "multicast": false,
    "locally_administered": false,
    "broadcast": false
  },
  "vendor": {
    "name": "Cumulus Networks, Inc",
    "found": true,
    "organization": "Cumulus Networks, Inc",
    "address": "650 Castro Street, Suite 120-245",
    "country": "US",
    "device_type": "networking",
    "source": "cache",
    "cached": true,
    "cache_age_s": 3600,
    "checked_at": "2025-01-15T12:00:00Z"
  },
  "meta": {
    "served_by": "pop=SJC country=US",
    "latency_ms": 12
  }
}

GET /v1/mac/info

حقول الرد

الحقل	النوع
`endpoint`	string
`description`	string
`parameters`	object
`example_request`	string
`example_response`	object

طلب مثال

curl -H "X-API-Key: $DOMSCAN_API_KEY" "https://domscan.net/v1/mac/info"

مثال الرد

{
  "endpoint": "/v1/mac",
  "description": "Lookup MAC address metadata and vendor information.",
  "parameters": {
    "mac": {
      "type": "string",
      "required": true,
      "description": "MAC address string in any common format",
      "example": "44:38:39:ff:ef:57"
    }
  },
  "example_request": "/v1/mac?mac=44:38:39:ff:ef:57",
  "example_response": {
    "mac": "44:38:39:FF:EF:57",
    "type": "eui-48",
    "oui": "44:38:39",
    "device_id": "FF:EF:57",
    "flags": {
      "multicast": false,
      "locally_administered": false,
      "broadcast": false
    },
    "vendor": {
      "name": "Cumulus Networks, Inc",
      "found": true,
      "source": "cache",
      "cached": true
    }
  }
}