開発者向けリファレンス

MAC アドレス検索 APIドキュメント

MAC アドレス検索 APIドキュメント: MACアドレス(OUI検索)からネットワークデバイスメーカーを特定します。EUI-48およびEUI-64アドレスをサポートし、一般的な形式です。ベンダー名、組織、住所、国、デバイスタイプ分類を返します。ネットワークインベントリ、セキュリティ監査、デバイス識別に役立ちます。

MAC アドレス検索

MACアドレス(OUI検索)からネットワークデバイスメーカーを特定します。EUI-48およびEUI-64アドレスをサポートし、一般的な形式です。ベンダー名、組織、住所、国、デバイスタイプ分類を返します。ネットワークインベントリ、セキュリティ監査、デバイス識別に役立ちます。

GET /v1/mac

クエリパラメータ

パラメータ	タイプ	説明
mac 必須	string	次の形式のMACアドレス: `44:38:39:FF:EF:57` ((コロン)) `44-38-39-FF-EF-57` ((ダッシュ)) `443839FFEF57` ((プレーン))

レスポンスフィールド

フィールド	説明
`mac`	正規化されたMACアドレス
`type`	アドレスタイプ(eui-48またはeui-64)
`oui`	組織的に一意の識別子(最初の3バイト)
`device_id`	ネットワークインターフェイスコントローラーID(最後の3バイト)
`flags`	マルチキャスト、locally_administered、ブロードキャスト
`vendor.name`	メーカー/ベンダー名
`vendor.organization`	フルの組織名
`vendor.country`	登録国
`vendor.device_type`	デバイスカテゴリー(既知の場合)

ユースケース

ネットワークデバイスインベントリ
ネットワーク上の不正なデバイスを特定
資産管理と監査
IoTデバイス分類

リクエスト例

curl "https://domscan.net/v1/mac?mac=44:38:39:ff:ef:57"

import requests

response = requests.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",
    "worker_version": "2.0.0",
    "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
    }
  }
}