Référence Développeur

Recherche d'Adresse MAC

Consultez la documentation de l'API Recherche d'Adresse MAC, ses paramètres de requête, les champs de réponse, les exemples de code et la gestion des erreurs pour les intégrations DomScan.

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",
    "worker_version": "2.14.0",
    "latency_ms": 12
  }
}

GET /v1/mac/info

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"

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