# O que desenvolvedores realmente devem se importar em uma API de Logo de Empresa

> A maioria das APIs de logo resolvem recuperação. O problema mais difícil é apresentação: painéis, CRMs e listas de contas permanecem visualmente consistentes apenas quando cada logo chega consciente de fundo, cortado automaticamente e ajustado em proporção.

## As quatro coisas que realmente importam

- **Tratamento de fundo** — quando um fundo de marca existe, a saída deve respeitá-lo.
- **Espaço em branco e corte** — logos não devem desperdiçar espaço ou parecer descentrados.
- **Consistência de proporção** — um slot de UI não deve produzir um peso visual diferente para cada marca.
- **Caminho de integração** — aplicativos de navegador precisam de um fluxo que funcione sem forçar um servidor no loop.

## Onde ClearLogo tem opinião

ClearLogo prioriza saída utilizável e um fluxo de chave pública amigável ao navegador, o que o torna um ajuste forte para painéis, CRMs, ferramentas de enriquecimento e superfícies de produtos internos.

### Exemplo de solicitação

```
GET https://api.clearlogo.dev/logo/example.com?size=128&content=80
```

```html
<img
  src="https://api.clearlogo.dev/logo/example.com?token=YOUR_BROWSER_KEY"
  alt="Example company logo"
/>
```

## Casos de uso com melhor ajuste

- Tabelas de empresas e diretórios
- Ferramentas de CRM e vendas
- Listas de contas dentro de painéis
- Aplicativos de navegador que precisam de URLs de logo sem um serviço de assinatura personalizado

## Perguntas Frequentes

### O que significa saída "consciente de fundo"?

ClearLogo detecta se o logo de uma marca espera um fundo colorido ou escuro e preserva esse fundo na resposta — em vez de sempre retornar um PNG transparente que pode parecer quebrado em superfícies claras.

### Preciso de um backend para usar ClearLogo?

Não. Uma chave de navegador autoriza solicitações via correspondência `Origin`/`Referer`, então você pode colocar URLs de logo diretamente em tags `<img>`. Use uma chave de servidor apenas para autenticação de bearer token do seu backend.

### Quais formatos de logo ClearLogo retorna?

PNG por padrão; `webp` e `jpeg` via o parâmetro `format` ou header `Accept`. Navegadores modernos recebem WebP automaticamente.

### Quando devo escolher ClearLogo em vez de uma fonte de logo genérica?

Quando logos ficam lado a lado em um slot de UI — painéis, CRMs, listas de contas, superfícies de enriquecimento — ajuste de proporção e tratamento de fundo são os diferenciadores.