Question 1

O que é ClearLogo?

Accepted Answer

ClearLogo é uma API de logo que retorna uma única imagem limpa para qualquer domínio. Diferentemente de fontes genéricas de logo, ela se concentra em apresentação: cada resposta é consciente do fundo, auto-recortada e ajustada em proporção para que logos pareçam consistentes dentro de dashboards, CRMs, tabelas de empresas e outras superfícies de produto.

Question 2

Preciso me registrar para testar a API?

Accepted Answer

Não. Você pode fazer solicitações anônimas para https://api.clearlogo.dev/logo/{domain} imediatamente para testes de baixo volume — nenhuma chave necessária. Para tráfego em produção, você precisará de uma chave de navegador ou chave de servidor do dashboard.

Question 3

Preciso de um servidor backend para usar ClearLogo?

Accepted Answer

Não. Uma chave de navegador permite que você incorpore URLs de logo diretamente em tags <img> do código frontend. As solicitações são validadas por correspondência de Origin/Referer contra os domínios permitidos que você configura na chave. Use uma chave de servidor apenas quando preferir autenticação Authorization: Bearer do seu backend.

Question 4

Por onde começo?

Accepted Answer

O caminho mais rápido: abra o playground, cole alguns domínios representativos e veja como a saída fica na sua interface. Depois que estiver satisfeito, crie uma chave de produção no dashboard e substitua a URL no seu código.

Question 5

Quais são os melhores casos de uso para ClearLogo?

Accepted Answer

ClearLogo é uma ótima opção sempre que logos ficam lado a lado e a consistência visual é importante — tabelas de empresas e diretórios, listas de contas de CRM, interfaces de enriquecimento, ferramentas de vendas e dashboards internos. Se você só precisa de um logo único atrás de um cache servidor e a consistência de apresentação não é uma preocupação, uma fonte genérica pode ser suficiente.

Question 6

Qual é a diferença entre uma chave de navegador e uma chave de servidor?

Accepted Answer

Uma chave de navegador (pk_…) é segura para usar em código frontend e tags <img>. As solicitações são autenticadas combinando o header Origin ou Referer com os domínios permitidos que você configura. Uma chave de servidor (sk_…) se autentica via Authorization: Bearer YOUR_KEY do seu backend e nunca deve ser exposta ao navegador.

Question 7

Como restriciono minha chave de navegador a domínios específicos?

Accepted Answer

No dashboard, abra as configurações da chave, ative Apenas Domínios Permitidos e adicione seus domínios um por linha. A notação com wildcard como *.example.com é suportada para subdomínios.

Question 8

O que acontece com solicitações sem um header Referer depois que ativo restrições de domínio?

Accepted Answer

Elas são bloqueadas. Tráfego direto e solicitações enviadas com Referrer-Policy: no-referrer ou same-origin falharão quando as restrições de domínio estiverem ativas. As políticas que funcionam incluem strict-origin-when-cross-origin, origin, origin-when-cross-origin e unsafe-url. Você pode verificar sua configuração procurando pelo header Referer em solicitações de img.logo.dev na aba Network do seu navegador antes de ativar as restrições.

Question 9

Como revejo ou substituo uma chave de API?

Accepted Answer

Crie uma nova chave no dashboard, atualize sua integração para usá-la e depois delete a chave antiga. Se você precisar de uma rotação urgente, entre em contato com support@clearlogo.dev.

Question 10

Quais formatos de imagem ClearLogo retorna?

Accepted Answer

png é o padrão. Você pode solicitar webp ou jpeg via o parâmetro de query format. Quando format é omitido, a API negocia conteúdo a partir do header de solicitação Accept — navegadores modernos carregando via <img> recebem WebP automaticamente.

Question 11

O que significa saída "consciente do fundo"?

Accepted Answer

ClearLogo detecta se o logo de uma marca foi projetado para um fundo colorido ou escuro e preserva esse fundo na imagem de resposta. Isso previne o problema comum de logos transparentes que parecem quebrados em superfícies claras.

Question 12

Quais tamanhos estão disponíveis?

Accepted Answer

O parâmetro size aceita potências de dois: 16, 32, 48, 64, 96, 128, 192, 256, 512 e 1024 pixels. A imagem é sempre quadrada. O padrão é 128 px. Valores fora desta lista são automaticamente ajustados para o tamanho permitido mais próximo (em caso de empate, o valor superior é escolhido).

Question 13

O que o parâmetro `theme` faz?

Accepted Answer

Definir theme=dark retorna a variante de logo com fundo escuro quando uma está disponível. Se nenhuma variante escura existir, a API volta para a versão padrão.

Question 14

Quais são os limites de taxa?

Accepted Answer

Os limites variam por plano — consulte a página de preços para detalhes. O uso por chave é retornado nos headers de resposta X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset para que você possa monitorar o consumo em tempo real.

Question 15

O que acontece quando excedo meu limite de taxa?

Accepted Answer

A API retorna HTTP 429 com um header Retry-After indicando quantos segundos esperar antes de tentar novamente. Entraremos em contato com você antes de tomar qualquer ação adicional — o serviço não é cortado sem aviso.

Question 16

Como verifico meu uso atual?

Accepted Answer

O uso em tempo real é visível no dashboard. Você também pode ler o header X-RateLimit-Remaining em qualquer resposta de API.

Question 17

Um logo não está aparecendo para um domínio — o que devo verificar?

Accepted Answer

Percorra esta lista de verificação: (1) confirme que o domínio é um nome de host simples sem scheme ou caminho, por exemplo github.com e não https://github.com/; (2) verifique que sua chave de API é válida e não expirou; (3) se as restrições de domínio estão ativadas, verifique se o header Referer está sendo enviado; (4) verifique o código de status da resposta — 404 significa que nenhum logo foi encontrado para esse domínio, 401 significa um problema de autenticação, 429 significa taxa limitada.

Question 18

O logo de um domínio parece errado ou desatualizado — o que posso fazer?

Accepted Answer

Entre em contato conosco em support@clearlogo.dev com o nome do domínio e uma nota sobre o que parece incorreto. Analisaremos e atualizaremos o ativo.

Question 19

Estou recebendo um erro 401 — o que isso significa?

Accepted Answer

Um 401 significa que a solicitação não foi autenticada. Para chaves de navegador, certifique-se de que o parâmetro de query token está incluído e que o header Origin/Referer corresponde a um domínio permitido. Para chaves de servidor, certifique-se de que o header Authorization: Bearer YOUR_KEY está presente e que a chave não foi deletada.

Question 20

Logos carregam em produção, mas não durante desenvolvimento local — como corrijo?

Accepted Answer

Adicione localhost (ou localhost:3000, localhost:5173, etc.) aos domínios permitidos da sua chave no dashboard. A API faz correspondência contra a origem exata, então inclua a porta se seu servidor dev usar uma não-padrão. Remova as entradas locais antes de distribuir a chave ou crie uma chave de desenvolvimento separada.

Question 21

Estou vendo erros CORS no navegador — como corrijo?

Accepted Answer

A API define headers CORS permissivos, então erros CORS geralmente indicam um header Referer faltando ou bloqueado em vez de um problema verdadeiro de CORS. Verifique a Referrer-Policy da sua página — políticas como no-referrer impedem que o header Referer seja enviado, o que causará falha nas solicitações quando as restrições de domínio estiverem ativas. Também verifique a tag <img> em si: um atributo referrerpolicy="no-referrer" ou referrerpolicy="same-origin" no elemento substitui a política de nível de página e remove Referer dessa solicitação específica.

Question 22

Quais planos estão disponíveis?

Accepted Answer

ClearLogo oferece um plano gratuito para uso de baixo volume e planos pagos para tráfego em produção. Consulte a página de preços para os detalhes do plano atual e limites de solicitação.

Question 23

Como faço upgrade do meu plano?

Accepted Answer

Visite o dashboard e selecione Upgrade do seu cartão de plano. Você será levado à página de faturamento onde pode escolher um plano e concluir o pagamento.

Question 24

Posso cancelar minha assinatura?

Accepted Answer

Sim. Você pode cancelar a qualquer momento no dashboard. Seu plano permanece ativo até o final do período de faturamento atual.

Ajuda & Perguntas Frequentes

Começando

Chaves de API & Autenticação

Saída & Formatação

Limites de Taxa & Uso

Solução de Problemas

Faturamento & Planos

Ainda tem alguma dúvida?