Generador muestra color SVG

La validación fallida se informa como invalid_input y no se factura, lo que mantiene seguros los constructores automáticos de leyendas cuando un campo del CMS aún guarda un nombre de color en borrador en lugar de un código hex.

Qué es una muestra de color SVG y cuándo la necesita

Una muestra de color es un rectángulo relleno pequeño que representa un único token de color: marca primaria, estado de peligro, serie A de un gráfico o un paso de paleta en un sistema de diseño. Esta capacidad estandariza ese chip: usted envía una cadena de color y recibe un SVG fijo con width, height, viewBox, role y un aria-label accesible, más el hex de seis dígitos expandido y los canales RGB para tablas junto al gráfico.

Contrato de entrada, reglas de validación y campos de respuesta

La forma abreviada de tres dígitos como #abc se expande a #aabbcc y se pasa a minúsculas para un contrato estable. El ancho y el alto opcionales son enteros de uno a quinientos doce inclusive; si los omite obtiene el chip predeterminado de veinticuatro por veinticuatro usado en leyendas densas. El rx opcional define un radio de esquina; debe ser un número finito mayor o igual que cero y no mayor que la mitad del lado menor, con valor predeterminado cero para esquinas vivas. El orden de atributos es fijo, de modo que la comparación byte a byte en pruebas permanece estable entre motores de JavaScript. Envíe por POST un objeto JSON con un campo color obligatorio: una cadena hex de tres o seis dígitos hexadecimales, con o sin hash inicial. Se aceptan los alias hex, fill, value, text e input para el mismo campo, de forma que widgets de formulario y scripts reutilicen nombres habituales. Longitudes inválidas, caracteres no hex, prefijos 0x, números sueltos y cadenas vacías fallan con invalid_input indicando el problema. En caso de éxito el cuerpo repite el color normalizado como color y hex, el hex_raw original recortado, los canales enteros r, g y b, el width, height y rx resueltos, una cadena view_box, un indicador shorthand, un mensaje breve y la cadena SVG dos veces como svg y markup para que los clientes que esperen cualquiera de los dos nombres enlacen sin mapear. La raíz SVG incluye siempre el espacio de nombres SVG, atributos width y height coincidentes, un viewBox de cero cero width height, role igual a img y un aria-label que incluye el hex normalizado para lectores de pantalla. El único rect usa el mismo width y height con fill al hex normalizado, e incluye rx solo cuando el radio es mayor que cero para que los goldens de esquina viva sigan siendo mínimos.

Dónde una API de muestra de color SVG aporta valor

Los bots de QA de diseño pueden regenerar cada muestra desde un archivo de tokens en CI y fallar la compilación cuando el marcado se desvía, capturando mayúsculas accidentales o hashes ausentes antes de publicar las notas de versión. Mantenga las solicitudes pequeñas, fije el campo svg en los goldens y obtendrá chips reproducibles para README, guías de estilo, bloques CMS y páginas de marketing en el borde sin montar una canalización de imágenes ni rasterizar colores a PNG en cada cambio de token. Los generadores de documentación que convierten tokens de diseño en páginas legibles pueden llamar a este endpoint una vez por token e inyectar el marcado devuelto junto al nombre del token, el valor hex y la nota de uso sin inventar plantillas SVG por framework. Los constructores de leyendas para gráficos y mapas necesitan chips del mismo tamaño con rellenos distintos; fijar width y height y variar solo el color mantiene la alineación predecible en tablas y filas flex. Como la implementación es parse puro de nivel A, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente, y la validación fallida no consume saldo.