Question 1

ClearLogoとは何ですか？

Accepted Answer

ClearLogoはロゴAPIで、任意のドメインに対して単一のクリーンな画像を返します。汎用のロゴソースとは異なり、プレゼンテーションに焦点を当てています。すべてのレスポンスは背景認識、自動トリミング、アスペクト比調整されており、ダッシュボード、CRM、企業テーブル、その他のプロダクトサーフェス内でロゴが一貫して見えます。

Question 2

APIを試すのに登録は必要ですか？

Accepted Answer

不要です。https://api.clearlogo.dev/logo/{domain}に対して匿名リクエストをすぐに行うことができます。低容量のテストではキーは不要です。本番環境のトラフィックでは、ダッシュボードからブラウザキーまたはサーバーキーが必要です。

Question 3

ClearLogoを使用するにはバックエンドサーバーが必要ですか？

Accepted Answer

いいえ。ブラウザキーを使用すると、フロントエンドコードから直接<img>タグにロゴURLを埋め込むことができます。リクエストはキーで設定した許可ドメインに対してOrigin/Refererマッチングで検証されます。バックエンドからAuthorization: Bearer認証を使用する場合は、サーバーキーのみを使用してください。

Question 4

どこから始めますか？

Accepted Answer

最速の方法は、プレイグラウンドを開き、いくつかの代表的なドメインを貼り付けて、UIでの出力の見え方を確認することです。満足したら、ダッシュボードで本番キーを作成し、URLをコードに置き換えます。

Question 5

ClearLogoの最適なユースケースは何ですか？

Accepted Answer

ClearLogoはロゴが並行して配置され、ビジュアル一貫性が重要な場所に最適です。企業テーブルとディレクトリ、CRMアカウントリスト、エンリッチメントUI、営業ツール、内部ダッシュボードなどです。サーバー側のキャッシュ背後に1回限りのロゴのみが必要で、プレゼンテーション一貫性が問題でない場合は、汎用ソースで十分かもしれません。

Question 6

ブラウザキーとサーバーキーの違いは何ですか？

Accepted Answer

ブラウザキー (pk_…)はフロントエンドコードと<img>タグで安全に配布できます。リクエストは設定した許可ドメインに対してOriginまたはRefererヘッダーをマッチングで認証します。サーバーキー (sk_…)はバックエンドからAuthorization: Bearer YOUR_KEYで認証され、ブラウザに露出させてはいけません。

Question 7

ブラウザキーを特定のドメインに制限するにはどうしますか？

Accepted Answer

ダッシュボードでキーの設定を開き、許可されたドメインのみを有効にして、ドメインを1行ずつ追加してください。サブドメイン用に*.example.comのようなワイルドカード表記がサポートされています。

Question 8

ドメイン制限を有効にした後、Refererヘッダーがないリクエストはどうなりますか？

Accepted Answer

ブロックされます。直接トラフィックとReferrer-Policy: no-referrerまたはsame-originで送信されたリクエストは、ドメイン制限がアクティブになるとエラーになります。動作するポリシーにはstrict-origin-when-cross-origin、origin、origin-when-cross-origin、unsafe-urlがあります。制限を有効にする前にブラウザのネットワークタブでimg.logo.devリクエストのRefererヘッダーを確認して、セットアップを検証できます。

Question 9

APIキーをローテーションまたは置き換えるにはどうしますか？

Accepted Answer

ダッシュボードで新しいキーを作成し、インテグレーションを更新してから、古いキーを削除してください。緊急のローテーションが必要な場合は、support@clearlogo.devにお問い合わせください。

Question 10

ClearLogoはどの画像フォーマットを返しますか？

Accepted Answer

pngがデフォルトです。formatクエリパラメータを使用してwebpまたはjpegをリクエストできます。formatが省略されている場合、APIはAcceptリクエストヘッダーからコンテンツネゴシエーションを行います。<img>経由でロードするモダンブラウザは自動的にWebPを受け取ります。

Question 11

「背景認識」出力とはどういう意味ですか？

Accepted Answer

ClearLogoはブランドのロゴが色付きまたはダークバックグラウンド用に設計されているかを検出し、そのバックグラウンドをレスポンス画像に保持します。これにより、ライトサーフェスで壊れて見える透明ロゴの一般的な問題を防ぎます。

Question 12

どのサイズが利用できますか？

Accepted Answer

sizeパラメータは16、32、48、64、96、128、192、256、512、1024ピクセルを受け付けます。画像は常に正方形です。デフォルトは128pxです。この一覧外の値は最も近い許容値に自動スナップされます（同距離の場合は上位値を選択）。

Question 13

`theme`パラメータは何をしますか？

Accepted Answer

theme=darkを設定すると、利用可能な場合、ロゴのダークバックグラウンド版が返されます。ダーク版が存在しない場合、APIは標準版にフォールバックします。

Question 14

レート制限は何ですか？

Accepted Answer

制限はプランによって異なります。詳細は価格ページを参照してください。キーごとの使用量はX-RateLimit-Limit、X-RateLimit-Remaining、X-RateLimit-Resetレスポンスヘッダーで返されるため、リアルタイムで消費を監視できます。

Question 15

レート制限を超えた場合はどうなりますか？

Accepted Answer

APIはHTTP 429を返します。Retry-Afterヘッダーは再試行までの待機秒数を示します。さらにアクションを取る前にご連絡します。サービスは警告なしにカットオフされません。

Question 16

現在の使用状況を確認するにはどうしますか？

Accepted Answer

リアルタイム使用はダッシュボードで確認できます。APIレスポンスのX-RateLimit-Remainingヘッダーも読むことができます。

Question 17

ドメインのロゴが表示されていません。何を確認すればよいですか？

Accepted Answer

このチェックリストを実行してください。(1)ドメインがスキームやパスのないベアホスト名であることを確認します。例えば、https://github.com/ではなくgithub.comのような形式です。(2)APIキーが有効で期限切れでないことを確認します。(3)ドメイン制限が有効な場合、Refererヘッダーが送信されていることを確認します。(4)レスポンスステータスコードを確認します。404はそのドメインでロゴが見つからなかったことを意味し、401は認証の問題、429はレート制限を意味します。

Question 18

ドメインのロゴが間違っているまたは古く見えます。何ができますか？

Accepted Answer

support@clearlogo.devにドメイン名と何が間違っているかについてのメモを付けてお問い合わせください。確認して、アセットを更新します。

Question 19

401エラーが発生しています。これはどういう意味ですか？

Accepted Answer

401はリクエストが認証されなかったことを意味します。ブラウザキーの場合、tokenクエリパラメータが含まれており、Origin/Refererヘッダーが許可されたドメインと一致していることを確認してください。サーバーキーの場合、Authorization: Bearer YOUR_KEYヘッダーが存在し、キーが削除されていないことを確認してください。

Question 20

ロゴは本番環境では読み込まれますが、ローカル開発中は読み込まれません。どう修正しますか？

Accepted Answer

ダッシュボードでキーの許可ドメインにlocalhost（またはlocalhost:3000、localhost:5173など）を追加してください。APIは正確なオリジンに対してマッチングするため、開発サーバーが標準以外のポートを使用する場合はポートを含めてください。配布する前にローカルエントリを削除するか、別の開発キーを作成してください。

Question 21

ブラウザでCORSエラーが見えています。どう修正しますか？

Accepted Answer

APIは寛容なCORSヘッダーを設定しているため、CORSエラーは通常、真のCORSの問題ではなく、欠落またはブロックされたRefererヘッダーを示しています。ページのReferrer-Policyを確認してください。no-referrerのようなポリシーはRefererヘッダーが送信されるのを防ぎ、ドメイン制限がアクティブなときはリクエストが失敗します。また、<img>タグ自体を確認してください。要素上のreferrerpolicy="no-referrer"またはreferrerpolicy="same-origin"属性はページレベルのポリシーをオーバーライドし、その特定のリクエストからRefererを削除します。

Question 22

どのプランが利用できますか？

Accepted Answer

ClearLogoは低容量ユースの無料プランと本番環境トラフィック用の有料プランを提供しています。現在のプラン詳細とリクエスト制限については、価格ページを参照してください。

Question 23

プランをアップグレードするにはどうしますか？

Accepted Answer

ダッシュボードにアクセスし、プランカードからアップグレードを選択してください。課金ページに移動して、プランを選択して支払いを完了できます。

Question 24

サブスクリプションをキャンセルできますか？

Accepted Answer

はい。ダッシュボードからいつでもキャンセルできます。現在の請求期間が終了するまで、プランはアクティブなままです。

ヘルプ & FAQ

はじめに

APIキー & 認証

出力 & フォーマット

レート制限 & 使用

トラブルシューティング

請求 & プラン

まだご質問がありますか？