ForHosting KIT · Daten & Dateien

MAC-Adresse mit Doppelpunkten formatieren und normalisieren

Der MAC-Adressformatierer überführt gängige Schreibweisen von Hardwareadressen in eine einheitliche Darstellung.

● BetaKostenlos · im Browser

Im Browser ausführen – kostenlos API ansehen

Nutzen Sie es über WebAPIE-MailTelegramApp bald

Fügen Sie eine Adresse mit Doppelpunkten, Bindestrichen, Punkten, Leerzeichen oder ohne Trennzeichen ein. Sie erhalten sechs großgeschriebene Hexadezimaloktette mit Doppelpunkten. Das Werkzeug ändert nicht nur Zeichen, sondern prüft auch den Wert: Nach Entfernung bekannter Trennzeichen müssen genau zwölf Hexadezimalziffern übrig bleiben. Damit eignet sich das Ergebnis für Konfigurationen, Inventare, Protokolle, API-Nutzdaten und zuverlässige Vergleiche.

Überführen Sie bekannte MAC-Schreibweisen in einen kanonischen Wert

MAC-Adressen können unterschiedlich aussehen und dennoch dieselbe Schnittstelle bezeichnen. Ein Arbeitsplatz zeigt vielleicht <code>a4-b1-c1-22-3d-4e</code>, ein Netzwerkgerät <code>a4b1.c122.3d4e</code> und ein Inventarexport <code>A4:B1:C1:22:3D:4E</code>. Ein direkter Zeichenvergleich behandelt diese Werte als verschieden. Dadurch entstehen doppelte Geräte, erfolglose Suchen oder unübersichtliche Abgleichberichte. Der Formatierer entfernt zulässige Trennzeichen, prüft die Hexadezimalfolge, wandelt Buchstaben in Großbuchstaben um und gruppiert die Ziffern in sechs Oktette mit jeweils zwei Zeichen. Die Ausgabe entspricht immer <code>A4:B1:C1:22:3D:4E</code>. Auch zwölf Ziffern ohne Trennung sowie durch Leerzeichen getrennte Oktette werden akzeptiert. Der Vorgang bestimmt weder Hersteller noch Erreichbarkeit oder tatsächliche Nutzung. Er löst gezielt die Aufgabe, einen stabilen Wert zu erzeugen, den andere Systeme einheitlich speichern, vergleichen, indizieren und anzeigen können.

Prüfen Sie die Adresse, statt nur Satzzeichen auszutauschen

Ein Formatierungswerkzeug darf fehlerhafte Daten nicht vertrauenswürdig aussehen lassen. Diese Funktion verlangt einen nicht leeren Text und erlaubt ausschließlich Hexadezimalzeichen sowie übliche MAC-Trennzeichen: Doppelpunkte, Bindestriche, Punkte und Leerzeichen. Danach entfernt sie diese Zeichen und prüft auf genau zwölf Hexadezimalziffern, also sechs Oktette mit je zwei Ziffern. Ein unzulässiges Zeichen, eine fehlende oder zusätzliche Ziffer sowie reine Zeichensetzung führen zu einem Fehler wegen ungültiger Eingabe und nie zu einem Teilergebnis. Die Position der Trennzeichen bleibt flexibel, weil kopierte Daten häufig Schreibweisen mischen; die Hexadezimallänge ist dagegen strikt. Auch Cisco-Gruppen lassen sich ohne Vorverarbeitung normalisieren. Nachgelagerter Code erhält somit entweder eine kanonische Adresse oder einen eindeutigen Fehler, niemals einen gekürzten, geraten ergänzten oder nur optisch bereinigten Wert mit weiterhin ungültiger Struktur.

Nutzen Sie kanonische Schreibweise zum Speichern und Vergleichen

Normalisieren Sie eine MAC-Adresse, bevor sie zum Datenbankschlüssel, Filter oder Bestandteil eines automatisierten Vergleichs wird. Nutzen Sie dies beim Import von Inventaren, Lesen von Befehlsausgaben, Bearbeiten von Supportfällen oder Erfassen über ein Formular. Speichern Sie den zurückgegebenen Wert <code>mac_address</code> und vergleichen Sie kanonische Werte statt der eingegebenen Zeichensetzung. So verschwinden Unterschiede bei Großschreibung und Trennzeichen, ohne Ziffern zu verändern. Der Formatierer ist deterministisch: Dieselbe gültige Eingabe liefert stets dieselbe Ausgabe, ohne Netzwerk, Zufall, Uhrzeit, Geräteabfrage oder Herstellerdatenbank. Er bestätigt auch keine reale Schnittstelle. Eine syntaktisch gültige Adresse kann unbenutzt, lokal verwaltet, Multicast oder für eine Richtlinie ungeeignet sein. Dafür ist eine getrennte Prüfung nötig. Der Vertrag bleibt klar: Eine bekannte Schreibweise wird in sechs Oktette überführt; alles, was nicht zwölf Hexadezimalziffern ergibt, wird abgelehnt.

Anwendungsfälle

Geräteinventar bereinigen

Normalisieren Sie Adressen verschiedener Anbieter, bevor Sie Notebooks, Access Points, Drucker und weitere Netzwerkgeräte deduplizieren.

Konfigurationswerte vorbereiten

Wandeln Sie kopierte Geräteausgaben in eine einheitliche Schreibweise um, bevor Sie diese in Konfigurationen oder API-Nutzdaten einfügen.

Formulare und Importe prüfen

Lehnen Sie Datensätze ohne sechs Oktette ab und akzeptieren Sie zugleich gängige Trennzeichen aus Eingaben und Exportdateien.

Häufige Fragen

Welche MAC-Adressformate werden akzeptiert?

Zulässig sind Schreibweisen mit Doppelpunkten, Bindestrichen, Punkten, Leerzeichen oder ohne Trennung. Mischungen sind möglich, doch zwölf Hexadezimalziffern müssen übrig bleiben.

Welches Format verwendet die Ausgabe?

Die Ausgabe verwendet sechs großgeschriebene Oktette mit je zwei Ziffern und Doppelpunkten, beispielsweise A4:B1:C1:22:3D:4E.

Wird geprüft, ob das Gerät existiert?

Nein. Es wird nur die Textstruktur geprüft und normalisiert; weder Netzwerk noch Gerät oder Zuweisung werden abgefragt.

Wird der Hardwarehersteller ermittelt?

Nein. Eine Herstellerabfrage gehört nicht zum Umfang, und es wird keine externe Datenbank verwendet.

Was geschieht bei falscher Länge?

Die Anfrage meldet eine ungültige Eingabe, wenn nach Entfernung der Trennzeichen nicht zwölf Hexadezimalziffern für sechs Oktette verbleiben.

Was kostet eine Anfrage?

Jede API-Anfrage kostet $0.002. Der deterministische Formatierer eignet sich auch für den erzeugten Browser-Ausführungspfad.

Für Entwickler — API-Zugang

Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.

Endpunkt

POSThttps://api.kit.forhosting.com/data/mac-address-format

Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.

Aufruf aus Ihrem Stack

curl -X POST https://api.kit.forhosting.com/data/mac-address-format \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"a4-b1-c1-22-3d-4e"}'

const res = await fetch("https://api.kit.forhosting.com/data/mac-address-format", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "a4-b1-c1-22-3d-4e"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/data/mac-address-format",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "a4-b1-c1-22-3d-4e"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/data/mac-address-format", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"a4-b1-c1-22-3d-4e"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"a4-b1-c1-22-3d-4e"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/data/mac-address-format", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Beispiel-Anfrage

{
  "text": "a4-b1-c1-22-3d-4e"
}

Beispiel-Antwort

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "data.mac_address_format",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Preis

pro Anfrage$0.002

Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.

Limits

max_mb 25

Fehler

HTTP	Code	Bedeutung
`401`	`unauthorized`	Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer).
`402`	`insufficient_balance`	Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht.
`404`	`unknown_type`	Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog.
`429`	`rate_limited`	Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt.

Vollständige KIT-Dokumentation lesen →