# 开发人员在公司徽标API上应该真正关心的内容

> 大多数徽标API解决检索。更难的问题是呈现：仪表板、CRM和帐户列表只有在每个徽标都到达背景感知、自动裁剪和比率适配时才能保持视觉一致。

## 实际重要的四件事

- **背景处理** — 当品牌背景存在时，输出应该尊重它。
- **空白和裁剪** — 徽标不应该浪费空间或感觉偏心。
- **比率一致性** — 一个UI插槽不应该为每个品牌生成不同的视觉重量。
- **集成路径** — 浏览器应用需要一个不会强制将服务器放入循环的流程。

## ClearLogo认为的地方

ClearLogo优先考虑可用的输出和浏览器友好的公钥流，使其成为仪表板、CRM、富集工具和内部产品表面的强大选择。

### 示例请求

```
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"
/>
```

## 最佳拟合用例

- 公司表格和目录
- CRM和销售工具
- 仪表板内的帐户列表
- 需要徽标URL的浏览器应用，无需自定义签名服务

## 常见问题

### "背景感知"输出是什么意思？

ClearLogo检测品牌的徽标是否期望彩色或深色背景，并在响应中保留该背景——而不是始终返回可能在浅色表面上看起来破损的透明PNG。

### 我需要后端来使用ClearLogo吗？

不。浏览器密钥通过`Origin`/`Referer`匹配来授权请求，因此您可以将徽标URL直接从前端代码放入`<img>`标签。仅当您想要来自后端的持有者令牌身份验证时才使用服务器密钥。

### ClearLogo返回什么徽标格式？

默认为PNG；通过`format`参数或`Accept`标头可用`webp`和`jpeg`。现代浏览器在加载时自动接收WebP。

### 什么时候应该选择ClearLogo而不是通用徽标源？

当徽标在UI插槽中彼此相邻坐着时——仪表板、CRM、帐户列表、富集表面——比率适配和背景处理是区别因素。