Spec

Extraits de code

curl "https://api.oanor.com/macaddr-api/v1/meta" \
  -H "x-oanor-key: oanor_test_..."

await fetch("https://api.oanor.com/macaddr-api/v1/meta", {
  headers: { "x-oanor-key": "oanor_test_..." }
});

$ch = curl_init("https://api.oanor.com/macaddr-api/v1/meta");
curl_setopt($ch, CURLOPT_HTTPHEADER, ["x-oanor-key: oanor_test_..."]);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$out = curl_exec($ch);

import requests
requests.get(
    "https://api.oanor.com/macaddr-api/v1/meta",
    headers={"x-oanor-key": "oanor_test_..."}
)

Exemple de réponse

Une réponse réelle de ce endpoint, capturée lors du dernier contrôle de santé.

{
    "data": {
        "name": "MAC Address API",
        "notes": "Accepts aa:bb:cc:dd:ee:ff, aa-bb-…, aabb.ccdd.eeff or aabbccddeeff. EUI-64 flips the U/L bit and inserts FF-FE, per RFC 4291. This formats and analyses the address — to look up the manufacturer behind a MAC use a MAC-vendor API. Nothing is stored.",
        "version": "v1",
        "endpoints": [
            {
                "path": "/v1/format",
                "params": {
                    "mac": "a MAC address in any notation (required)",
                    "case": "lower (default) or upper",
                    "format": "colon (default), hyphen, dot (cisco), or bare"
                },
                "returns": "the MAC in the chosen notation and all common formats"
            },
            {
                "path": "/v1/info",
                "params": {
                    "mac": "a MAC address (required)"
                },
                "returns": "OUI/NIC, unicast/multicast, U/L scope, EUI-64 and link-local IPv6"
            },
            {
                "path": "/v1/meta",
                "params": [],
                "returns": "this document"
            }
        ],
        "description": "Validate, reformat and analyse MAC (EUI-48) addresses. The format endpoint accepts a MAC in any common notation — colon, hyphen, Cisco dotted or bare — and returns it in the notation you want plus all the others, in upper or lower case. The info endpoint analyses an address: its OUI (manufacturer prefix) and NIC parts, whether it is unicast or multicast (the I/G bit) and universally or locally administered (the U/L bit), whether it is the broadcast address, and the derived Modified EUI-64 interface identifier and the matching IPv6 link-local address (fe80::…). Pure local, no key."
    },
    "meta": {
        "timestamp": "2026-06-03T09:25:01.478Z",
        "request_id": "50c56641-7609-4db4-a2d8-c5edba13fb24"
    },
    "status": "ok",
    "message": "Meta",
    "success": true
}