MAClens

Analyse d’adresse MAC

Mon compte
fren

Documentation de l’API

L’API MAClens renvoie, au format JSON, l’analyse d’une adresse MAC : formats normalisés, bits I/G et U/L, constructeur issu des registres IEEE MA-L, MA-M et MA-S, et cas particuliers documentés.

Endpoints

Un seul endpoint public est exposé :

  • GET /api/mac/:mac

    Accessible depuis n’importe quel site ou script (CORS autorisé). À utiliser pour les appels externes.

Authentification

Sans clé, l’accès gratuit est limité à 100 requêtes par jour. Pour utiliser le quota de votre formule, transmettez votre clé dans chaque requête.

En-tête recommandé

X-API-Key: YOUR_API_KEY

L’en-tête Authorization est également accepté :

Authorization: Bearer YOUR_API_KEY

Gardez votre clé côté serveur : ne l’intégrez pas dans le code envoyé au navigateur.

Paramètres

?lang=lang
fr ou en (par défaut : en)
:mac
L’adresse MAC, avec ou sans séparateurs (:, -, .) ou en hexadécimal continu.

Structure de la réponse

  • address — formats canonique, hexadécimal, tirets, Cisco et EUI-64.
  • bits — I/G (transmission), U/L (administration : universal ou local).
  • vendor — nom, préfixe, type de registre IEEE, pays et drapeau.
  • special — titre, résumé et usage pour les adresses réservées.

Erreurs

  • 400 missing_mac — aucune adresse fournie.
  • 422 invalid_mac — format non reconnu.

Exemples d’intégration

Remplacez :mac par l’adresse à analyser.

Chaque exemple utilise l’en-tête X-API-Key et demande une réponse en français.

cURL CLI

curl -s -H "X-API-Key: YOUR_API_KEY" "https://maclens.net/api/mac/28:6F:B9:12:34:56?lang=fr"

PHP — cURL

<?php
$curl = curl_init('https://maclens.net/api/mac/28:6F:B9:12:34:56?lang=fr');
curl_setopt_array($curl, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);

$response = curl_exec($curl);
curl_close($curl);
$result = json_decode($response, true);

PHP — Symfony HttpClient

<?php
use Symfony\Component\HttpClient\HttpClient;

$client = HttpClient::create();
$response = $client->request('GET', 'https://maclens.net/api/mac/28:6F:B9:12:34:56?lang=fr', [
    'headers' => ['X-API-Key' => 'YOUR_API_KEY'],
]);

$result = $response->toArray();

JavaScript — fetch

const response = await fetch('https://maclens.net/api/mac/28:6F:B9:12:34:56?lang=fr', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});

if (!response.ok) throw new Error(`HTTP ${response.status}`);
const result = await response.json();

JavaScript — Axios

import axios from 'axios';

const { data } = await axios.get('https://maclens.net/api/mac/28:6F:B9:12:34:56?lang=fr', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' },
});

Python — Requests

import requests

response = requests.get(
    'https://maclens.net/api/mac/28:6F:B9:12:34:56?lang=fr',
    headers={'X-API-Key': 'YOUR_API_KEY'},
    timeout=10,
)
response.raise_for_status()
result = response.json()

À lire aussi