# 開発者が企業ロゴAPIについて実際に気にするべきこと

> ほとんどのロゴAPIは取得を解決します。より難しい問題はプレゼンテーションです。ダッシュボード、CRM、およびアカウントリストはすべてのロゴが背景対応、自動トリミング、比率フィットで到着する場合にのみ、ビジュアル一貫性を保ちます。

## 実際に重要な4つのこと

- **背景処理** — ブランドの背景が存在する場合、出力はそれを尊重する必要があります。
- **ホワイトスペースとトリミング** — ロゴはスペースを浪費したり、中心から外れたりしないようにしてください。
- **比率の一貫性** — 1つの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が必要なブラウザアプリ

## FAQ

### 「背景対応」出力とはどういう意味ですか？

ClearLogoは、ブランドのロゴが色付きまたは濃い背景を期待しているかどうかを検出し、透明なPNGを常に返す代わりに、応答でその背景を保持します。これは明るいサーフェスで破られているように見える場合があります。

### ClearLogoを使用するためにバックエンドが必要ですか？

いいえ。ブラウザキーは`Origin`/`Referer`マッチングを介してリクエストを認可するため、ロゴURLをフロントエンドコードの`<img>`タグに直接ドロップできます。バックエンドキーは、バックエンドからベアラートークン認証が必要な場合にのみ使用してください。

### ClearLogoはどのロゴ形式を返しますか？

デフォルトではPNG、`webp`と`jpeg`は`format`パラメータまたは`Accept`ヘッダーから自動コンテンツネゴシエーションを介して利用可能です。モダンブラウザは`<img>`経由で読み込む際にWebPを自動的に受け取ります。

### 汎用ロゴソースよりもClearLogoを選ぶべきはいつですか？

ロゴがUIスロット内で隣同士に座っている場合 — ダッシュボード、CRM、アカウントリスト、エンリッチメントサーフェス — 比率フィットと背景処理が差別化器です。