ForHosting KIT · Ferramentas para dev

Validar cor hexadecimal

O validador de cores hexadecimais oferece uma resposta direta e determinística para códigos usados em CSS, tokens de design, temas, arquivos de configuração e marcação gerada.

● BetaGrátis · no seu navegador

Executar grátis Ver a API

Use pelo WebAPIE-mailTelegramApp em breve

Ele aceita os formatos padrão de três, quatro, seis e oito dígitos, com ou sem cerquilha inicial, e verifica cada caractere sem adivinhar nem corrigir o valor. O resultado é um booleano simples para formulários, testes, importações ou fluxos com API. Campos ausentes e tipos incorretos geram erros claros, portanto um problema na requisição nunca é confundido com uma cor inválida.

O que é uma cor hexadecimal válida

Uma cor hexadecimal válida contém exatamente três, quatro, seis ou oito dígitos hexadecimais. Três dígitos representam RGB abreviado; quatro representam RGBA abreviado com alfa; seis correspondem a RGB completo e oito a RGBA completo. A cerquilha inicial é opcional, pois CSS, bancos de dados, ferramentas de design e configurações nem sempre armazenam o prefixo da mesma forma. Depois desse prefixo opcional, cada caractere precisa ser um dígito ASCII de 0 a 9 ou uma letra de A a F, maiúscula ou minúscula. O verificador não aceita espaços, pontuação, sinais, cerquilhas repetidas, nomes de cores, funções CSS nem qualquer outro comprimento. Ele também não remove espaços da entrada. Essa rigidez revela espaços ocultos e evita aprovar silenciosamente um valor diferente da fonte armazenada. Assim, o booleano <code>valid</code> descreve exatamente a string fornecida por você.

Como a validação determinística ajuda

Validar uma cor é simples, mas regras inconsistentes causam defeitos duradouros. Um navegador pode rejeitar um formato, uma biblioteca pode normalizar outro e uma expressão regular feita à mão pode esquecer o alfa abreviado ou aceitar cinco dígitos sem querer. Esta capacidade usa uma regra explícita: remove uma única cerquilha opcional, confirma um dos quatro comprimentos permitidos e verifica se todos os caracteres pertencem ao alfabeto hexadecimal. Não há rede, aleatoriedade, data, regra regional, conversão de caixa nem interpretação do espaço de cor. A mesma entrada produz o mesmo booleano no widget e na API. Strings de cor inválidas retornam <code>false</code> como resultado normal; elas não são requisições excepcionais. Já a ausência do campo ou o envio de número, lista ou objeto no lugar de string produz um erro de entrada claro. Assim, seu aplicativo informa uma cor inválida e ainda detecta integrações quebradas ou payloads com formato incorreto.

Uso do resultado em formulários e pipelines

Use o validador logo antes de uma cor cruzar um limite de confiança. Em um formulário, execute-o ao alterar o campo ou antes do envio e mostre uma mensagem objetiva quando <code>valid</code> for falso. Em uma importação de tokens, valide cada valor antes de gerar CSS para impedir que um token malformado invalide uma folha de estilos ou se espalhe por um tema. Em um pipeline, preserve a string original e armazene o booleano ao lado dela quando precisar de auditoria; não substitua a fonte por um valor normalizado, pois esta capacidade valida e não transforma. Se você precisar expandir, converter ou extrair canais, valide primeiro e encaminhe os valores aprovados à capacidade adequada. A execução no navegador atende verificações interativas, enquanto a API custa US$ 0,002 por requisição. A resposta estável funciona diretamente em condições e testes de limites, símbolos inválidos, prefixos extras, vazios e espaços.

Casos de uso

Verificar um campo de cor

Confirme um formato RGB ou RGBA permitido antes de salvar a preferência de tema de uma pessoa.

Validar tokens de design

Rejeite cores malformadas antes de converter tokens em variáveis CSS ou constantes do aplicativo.

Proteger estilos gerados

Teste cores de fontes externas antes de inseri-las em folhas de estilo ou configurações de componentes.

Perguntas frequentes

Quais comprimentos são válidos?

Exatamente 3, 4, 6 ou 8 dígitos hexadecimais, sem contar a cerquilha inicial opcional.

A cerquilha inicial é obrigatória?

Não. Tanto #336699 quanto 336699 são representações válidas para este verificador.

Letras maiúsculas são aceitas?

Sim. As letras hexadecimais de A a F são aceitas em maiúsculas ou minúsculas.

O validador remove espaços?

Não. Espaços no início ou no fim tornam a cor inválida e revelam problemas de formatação.

Quanto custa?

A API custa US$ 0,002 por requisição, e a mesma verificação determinística pode rodar no seu 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/color/is-valid-hex

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/color/is-valid-hex \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"text":"#336699cc"}'

const res = await fetch("https://api.kit.forhosting.com/color/is-valid-hex", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "text": "#336699cc"
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/color/is-valid-hex",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "text": "#336699cc"
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/color/is-valid-hex", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"text":"#336699cc"}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"text":"#336699cc"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/color/is-valid-hex", 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": "#336699cc"
}

Exemplo de resposta

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "color.is_valid_hex",
  "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.

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 →