개발자 참고자료

MAC 주소 조회

DomScan 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바이트)
flagsmulticast, 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 크레딧: 0

응답 필드

필드 유형
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"
const response = await fetch("https://domscan.net/v1/mac/info", {
  headers: { "X-API-Key": process.env.DOMSCAN_API_KEY },
});
const data = await response.json();
console.log(data);
import os
import requests

response = requests.get(
    "https://domscan.net/v1/mac/info",
    headers={"X-API-Key": os.environ["DOMSCAN_API_KEY"]},
)
print(response.json())
package main

import (
	"fmt"
	"io"
	"net/http"
	"os"
)

func main() {
	req, err := http.NewRequest(http.MethodGet, "https://domscan.net/v1/mac/info", nil)
	if err != nil {
		panic(err)
	}
	req.Header.Set("X-API-Key", os.Getenv("DOMSCAN_API_KEY"))

	resp, err := http.DefaultClient.Do(req)
	if err != nil {
		panic(err)
	}
	defer resp.Body.Close()

	data, err := io.ReadAll(resp.Body)
	if err != nil {
		panic(err)
	}
	fmt.Println(resp.Status, string(data))
}
require "json"
require "net/http"

uri = URI("https://domscan.net/v1/mac/info")
request = Net::HTTP::Get.new(uri)
request["X-API-Key"] = ENV.fetch("DOMSCAN_API_KEY")

response = Net::HTTP.start(uri.hostname, uri.port, use_ssl: true) do |http|
  http.request(request)
end
puts JSON.pretty_generate(JSON.parse(response.body))

예제 응답

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

HTTP 상태 코드

  • 200 성공
  • 401 인증되지 않음
  • 429 요청 과다