Gerador de amostra de cor SVG

A validação falha é reportada como invalid_input e não é cobrada, o que mantém construtores automáticos de legenda seguros quando um campo do CMS ainda guarda um nome de cor em rascunho em vez de um código hex.

O que é uma amostra de cor SVG e quando você precisa dela

Esta capacidade padroniza esse chip: você envia uma string de cor e recebe um SVG fixo com width, height, viewBox, role e um aria-label acessível, além do hex de seis dígitos expandido e dos canais RGB para tabelas ao lado do gráfico.

Contrato de entrada, regras de validação e campos da resposta

A forma abreviada de três dígitos como #abc expande para #aabbcc e fica em minúsculas para um contrato estável. Largura e altura opcionais são inteiros de um a quinhentos e doze inclusive; se omitir, você obtém o chip padrão de vinte e quatro por vinte e quatro usado em legendas densas. O rx opcional define um raio de canto; deve ser um número finito maior ou igual a zero e não maior que a metade do lado menor, com padrão zero para cantos retos. A ordem dos atributos é fixa, de modo que a comparação byte a byte em testes permanece estável entre motores de JavaScript. Envie por POST um objeto JSON com um campo color obrigatório: uma string hex de três ou seis dígitos hexadecimais, com ou sem hash inicial. Os aliases hex, fill, value, text e input são aceitos para o mesmo campo, para que widgets de formulário e scripts reutilizem nomes comuns. Comprimentos inválidos, caracteres não hex, prefixos 0x, números soltos e strings vazias falham com invalid_input indicando o problema. Em caso de sucesso o corpo ecoa a cor normalizada como color e hex, o hex_raw original aparado, os canais inteiros r, g e b, o width, height e rx resolvidos, uma string view_box, um indicador shorthand, uma mensagem curta e a string SVG duas vezes como svg e markup para clientes que esperem qualquer um dos nomes vincularem sem mapeamento. A raiz SVG inclui sempre o namespace SVG, atributos width e height coincidentes, um viewBox de zero zero width height, role igual a img e um aria-label que inclui o hex normalizado para leitores de tela. O único rect usa o mesmo width e height com fill no hex normalizado, e inclui rx só quando o raio é maior que zero para que goldens de canto reto permaneçam mínimos.

Onde uma API de amostra de cor SVG vale a pena

Bots de QA de design podem regenerar cada amostra a partir de um arquivo de tokens no CI e falhar o build quando a marcação desvia, capturando maiúsculas acidentais ou hashes ausentes antes das notas de versão. Mantenha as solicitações pequenas, fixe o campo svg nos goldens e você obtém chips reproduzíveis para README, guias de estilo, blocos CMS e páginas de marketing na borda sem montar um pipeline de imagens nem rasterizar cores em PNG a cada mudança de token. Geradores de documentação que transformam tokens de design em páginas legíveis podem chamar este endpoint uma vez por token e injetar a marcação retornada ao lado do nome do token, do valor hex e da nota de uso sem inventar templates SVG por framework. Construtores de legenda para gráficos e mapas precisam de chips do mesmo tamanho com preenchimentos diferentes; fixar width e height e variar só a cor mantém o alinhamento previsível em tabelas e linhas flex. Como a implementação é parse puro tier A, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída, e a validação falha não consome saldo.