개발자 참고자료
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바이트) |
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
크레딧: 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요청 과다