개발자 참고자료

MAC 주소 조회

MAC 주소 조회 API 문서에서 요청 매개변수, 응답 필드, 코드 예제, DomScan 통합을 위한 오류 처리를 확인하세요.

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`	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",
    "worker_version": "2.14.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
    }
  }
}