Geliştirici Referansı

MAC Adresi Araması

MAC Adresi Araması API belgelerini, istek parametrelerini, yanıt alanlarını, kod örneklerini ve DomScan entegrasyonları için hata işlemeyi inceleyin.

MAC Adresi Araması

MAC adreslerinden ağ cihazı üreticilerini belirleyin (OUI araması). Yaygın tüm biçimlerdeki EUI-48 ve EUI-64 adreslerini destekler. Satıcı adını, kuruluşu, adresi, ülkeyi ve cihaz türü sınıflandırmasını döndürür. Ağ envanteri, güvenlik denetimi ve cihaz tanımlama için kullanışlıdır.

GET /v1/mac

Sorgu Parametreleri

Parametre	Tür	Açıklama
mac gerekli	string	Herhangi bir biçimde MAC adresi: `44:38:39:FF:EF:57` ((iki nokta üst üste)) `44-38-39-FF-EF-57` ((tire)) `443839FFEF57` ((düz))

Yanıt Alanları

Alan	Açıklama
`mac`	Normalleştirilmiş MAC adresi
`type`	Adres türü (eui-48 veya eui-64)
`oui`	Kuruluşlara Özgü Tanımlayıcı (ilk 3 bayt)
`device_id`	Ağ Arayüz Denetleyicisi kimliği (son 3 bayt)
`flags`	multicast, locally_administered, broadcast
`vendor.name`	Üretici/satıcı adı
`vendor.organization`	Tam kuruluş adı
`vendor.country`	Kayıt ülkesi
`vendor.device_type`	Cihaz kategorisi (biliniyorsa)

Kullanım Alanları

Ağ cihazı envanteri
Ağdaki yetkisiz cihazları belirleme
Varlık yönetimi ve denetimi
IoT cihazı sınıflandırması

Örnek İstek

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)")

Örnek Yanıt

{
  "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

Yanıt Alanları

Alan	Tür
`endpoint`	string
`description`	string
`parameters`	object
`example_request`	string
`example_response`	object

Örnek İstek

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

Örnek Yanıt

{
  "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
    }
  }
}