ForHosting KIT · Dados e planilhas

Formate e normalize um endereço MAC com dois-pontos

O formatador de endereços MAC converte notações comuns de endereços físicos em uma representação previsível.

● BetaGrátis · no seu navegador

Use pelo WebAPIE-mailTelegramApp em breve

Cole um endereço com dois-pontos, hífens, pontos, espaços ou sem separadores para receber seis octetos hexadecimais em maiúsculas separados por dois-pontos. Além de trocar a pontuação, ele valida o valor: depois da remoção dos separadores reconhecidos, devem restar exatamente doze dígitos hexadecimais. O resultado é adequado para configurações, inventários, logs, cargas de API e comparações confiáveis.

Converta notações MAC conhecidas em um valor canônico

Endereços MAC podem ter aparências diferentes mesmo quando identificam a mesma interface. Uma estação pode exibir <code>a4-b1-c1-22-3d-4e</code>, um equipamento de rede pode mostrar <code>a4b1.c122.3d4e</code> e uma exportação pode conter <code>A4:B1:C1:22:3D:4E</code>. A comparação literal considera esses valores diferentes, criando ativos duplicados, consultas perdidas ou relatórios de conciliação ruidosos. Este formatador remove separadores reconhecidos, verifica a sequência hexadecimal, converte letras em maiúsculas e agrupa os dígitos em seis octetos de dois caracteres. A saída sempre segue o modelo <code>A4:B1:C1:22:3D:4E</code>. Também são aceitos doze dígitos contínuos e octetos separados por espaços. A operação não identifica fabricantes, não contata dispositivos e não determina se o endereço está em uso. Ela resolve o problema específico de criar um valor estável para outros sistemas armazenarem, compararem, indexarem ou exibirem com consistência.

Valide o endereço em vez de apenas trocar a pontuação

Uma ferramenta de formatação não deve fazer dados incorretos parecerem confiáveis. A capacidade exige texto não vazio e permite somente caracteres hexadecimais e separadores comuns de endereços MAC: dois-pontos, hífens, pontos e espaços. Depois de removê-los, verifica se restam exatamente doze dígitos hexadecimais, equivalentes a seis octetos de dois dígitos. Se houver um caractere fora do conjunto, um dígito a mais ou a menos, ou apenas pontuação, a solicitação retorna um erro de entrada inválida, nunca um resultado parcial. A posição dos separadores é flexível porque dados copiados frequentemente misturam estilos, mas o comprimento hexadecimal é rigoroso. Grupos no estilo Cisco, por exemplo, são normalizados sem pré-processamento. Assim, o código seguinte recebe um endereço canônico ou uma falha clara, jamais um valor truncado, preenchido por suposição ou visualmente corrigido cuja estrutura continue inválida.

Use notação canônica para armazenar e comparar com segurança

Normalize antes de usar um endereço MAC como chave de banco de dados, filtro ou parte de uma comparação automatizada. Aplique o recurso ao importar inventários, ler saídas de comandos, processar chamados ou receber um endereço por formulário. Armazene o valor <code>mac_address</code> retornado e compare valores canônicos, não a pontuação fornecida pelo usuário. Isso elimina diferenças de caixa e separadores sem alterar os dígitos. O formatador é determinístico: a mesma entrada válida sempre produz a mesma saída e não usa rede, aleatoriedade, relógio, consulta a dispositivo nem base de fabricantes. Também não afirma que o endereço pertença a uma interface real. Um endereço sintaticamente válido ainda pode estar sem uso, ser administrado localmente, multicast ou inadequado para determinada política. Essas verificações exigem outra regra. Aqui o contrato permanece simples: entra uma notação reconhecida, sai uma representação de seis octetos e qualquer valor que não resulte em doze dígitos hexadecimais é rejeitado.

Casos de uso

Limpar um inventário de ativos

Normalize endereços de vários fornecedores antes de eliminar duplicatas de notebooks, pontos de acesso, impressoras e outros equipamentos.

Preparar valores de configuração

Converta saídas copiadas de dispositivos em notação uniforme antes de inseri-las em um arquivo de configuração ou carga de API.

Validar formulários e importações

Rejeite registros que não formem seis octetos e aceite os separadores comuns fornecidos por usuários e arquivos exportados.

Perguntas frequentes

Quais formatos de endereço MAC são aceitos?

São aceitas formas com dois-pontos, hífens, pontos, espaços ou sem separadores. Os separadores podem ser misturados, mas devem restar exatamente doze dígitos hexadecimais.

Qual formato é usado no resultado?

O resultado usa seis octetos de dois dígitos em maiúsculas separados por dois-pontos, como A4:B1:C1:22:3D:4E.

A ferramenta verifica se o dispositivo existe?

Não. Ela apenas valida e normaliza a estrutura textual; não consulta a rede, contata o dispositivo nem confirma a atribuição.

Ela identifica o fabricante do equipamento?

Não. A consulta de fabricante está fora do escopo, e nenhuma base de dados externa é acessada.

O que ocorre quando o tamanho está incorreto?

A solicitação retorna um erro de entrada inválida se a remoção dos separadores não deixar doze dígitos hexadecimais, correspondentes a seis octetos.

Quanto custa uma solicitação?

Cada solicitação de API custa US$ 0,002. O formatador determinístico também pode usar a rota de execução gerada para navegador.

Para desenvolvedores — acesso via API

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

Endpoint

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

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

Chame do seu código

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)

Exemplo de requisição

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

Exemplo de resposta

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

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

Preço

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

Limites

max_mb 25

Erros

HTTP	Código	O que significa
`401`	`unauthorized`	Token ausente ou inválido. Confira o header Authorization.
`402`	`insufficient_balance`	Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
`404`	`unknown_type`	Esse tipo de tarefa não existe. Confira o campo type no catálogo.
`429`	`rate_limited`	Muitas requisições em pouco tempo. Espere um instante e tente de novo.

Ver a documentação completa do KIT →