Validador UUID

Em caso de sucesso, ele retorna a forma canônica normalizada em minúsculas, a variante codificada nos bits da sequência de relógio e a versão gravada no UUID. Letras hexadecimais maiúsculas e minúsculas são aceitas, mas chaves, textos compactos, separadores fora do lugar e caracteres não hexadecimais não passam silenciosamente.

O que este validador de UUID verifica

Um UUID contém 128 bits, mas pessoas e sistemas normalmente o trocam como 36 caracteres visíveis organizados em cinco grupos: oito caracteres hexadecimais, seguidos por quatro, quatro, quatro e doze, com hífens entre eles. Este validador confere exatamente essa representação. Ele verifica o comprimento total, confirma que cada separador está na posição correta e recusa qualquer caractere que não seja um dígito hexadecimal ou hífen. As letras hexadecimais podem estar em maiúsculas ou minúsculas, pois a caixa não altera os bits subjacentes. Espaços, chaves, prefixo URN, valores compactos de 32 caracteres e pontuação no final não são removidos de forma silenciosa. Esse limite rigoroso é útil quando você testa o contrato de uma API ou de um campo de banco de dados: a entrada corresponde ao formato UUID documentado ou recebe uma justificativa que indica o problema estrutural. Uma resposta bem-sucedida inclui valid como verdadeiro e fornece um valor canônico em minúsculas para comparações estáveis, chaves de cache, fixtures e logs. A validação é determinística e não consulta cadastros, gera outro identificador nem afirma que o UUID exista em algum sistema externo.

Como a variante e a versão são decodificadas

Os metadados do UUID ficam codificados no próprio identificador, sem necessidade de consulta. A versão é o dígito hexadecimal no início do terceiro grupo; o validador converte esse dígito em um inteiro de 0 a 15 e o informa diretamente. Entre as versões atribuídas mais comuns estão a versão 1 baseada em tempo, as versões 3 e 5 baseadas em nome, a versão 4 aleatória, a versão 6 com tempo reordenado, a versão 7 com tempo Unix e a versão 8 personalizada. A variante vem dos bits iniciais do quarto grupo. Um bit inicial zero é indicado como ncs; o padrão 10 aparece como rfc_4122, família usada nos formatos UUID modernos; 110 aparece como microsoft; e 111 como future. Informar os bits é diferente de impor um perfil de aplicação. Um UUID estruturalmente correto pode carregar uma versão reservada ou uma variante antiga. Por isso, a ferramenta descreve o que está codificado, sem presumir que todo valor bem-formado precise ser da versão 4. Depois, sua aplicação pode aplicar a própria política aos campos retornados.

Canonização, erros e uso prático

A canonização altera somente a caixa das letras hexadecimais: os cinco grupos e todos os dígitos permanecem intactos, enquanto as letras de A a F passam para minúsculas. Assim, duas grafias aceitas do mesmo valor de 128 bits produzem exatamente o mesmo texto canônico. O validador não remove espaços nem corrige um valor quase certo, porque a limpeza automática pode esconder uma falha na fronteira de serialização. Em vez disso, um valor vazio, um valor que não seja texto, uma contagem incorreta de caracteres, hífens deslocados e caracteres ilegais geram mensagens explicativas diferentes. Isso torna a capacidade adequada para bloqueios de importação, diagnóstico de formulários, fixtures de teste e ferramentas de suporte em que a causa é tão importante quanto a resposta positiva ou negativa. Envie um candidato no campo text; os aliases uuid e value também são aceitos para facilitar a integração. A operação custa US$ 0,002 por item via API e funciona sem rede, aleatoriedade, relógio, modelo ou armazenamento persistente. Ela verifica apenas a sintaxe e os metadados incorporados; não determina exclusividade, propriedade, presença em banco de dados, qualidade da geração ou adequação a um protocolo específico.