Référence développeur
Recherche d'Adresse MAC
API DomScan : Identifiez les fabricants de périphériques réseau à partir des adresses MAC (recherche OUI).
Recherche d'Adresse MAC
Identifiez les fabricants de périphériques réseau à partir des adresses MAC (recherche OUI). Prend en charge les adresses EUI-48 et EUI-64 dans tous les formats courants. Retourne le nom du fournisseur, l'organisation, l'adresse, le pays et la classification du type de périphérique. Utile pour l'inventaire réseau, l'audit de sécurité et l'identification des périphériques.
GET
/v1/mac
Paramètres de requête
| Paramètre | Type | Description |
|---|---|---|
| mac requis | string | Adresse MAC dans n'importe quel format :44:38:39:FF:EF:57 ((deux-points))44-38-39-FF-EF-57 ((tiret))443839FFEF57 ((simple)) |
Champs de réponse
| Champ | Description |
|---|---|
mac | Adresse MAC normalisée |
type | Type d'adresse (eui-48 ou eui-64) |
oui | Identificateur Unique Organisationnel (premiers 3 octets) |
device_id | ID du Contrôleur d'Interface Réseau (3 derniers octets) |
flags | multidiffusion, administrée_localement, diffusion |
vendor.name | Nom du fabricant/fournisseur |
vendor.organization | Nom complet de l'organisation |
vendor.country | Pays d'enregistrement |
vendor.device_type | Catégorie de périphérique (le cas échéant) |
Cas d'utilisation
- Inventaire des périphériques réseau
- Identifiez les périphériques non autorisés sur le réseau
- Gestion et audit des actifs
- Classification des périphériques IoT
Exemple de requête
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)")
Exemple de réponse
{
"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
Crédits: 0
Champs de réponse
| Champ | Type |
|---|---|
endpoint |
string |
description |
string |
parameters |
object |
example_request |
string |
example_response |
object |
Exemple de requête
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))Exemple de réponse
{
"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
}
}
}
Codes de statut HTTP
200OK401Non autorisé429Trop de requêtes