利用状況インサイトの埋め込み

トークンを作成してページを埋め込む

1. 組織管理者または個人アカウントの所有者として、既存のインサイトダッシュボードで「埋め込み／共有」を開きます。
2. アカウント・組織全体または単一の API キーを選択します。https://portal.example.com などの正確な HTTPS オリジンを登録します。登録数の上限 N は設定で決まります。
3. 設定された最大期間内の有効期限を選ぶか、プラットフォームが許可する場合は無期限にして、トークンを作成します。
4. 一度だけ表示される blemb_ トークン、埋め込み URL、iframe コードを保存し、許可ドメインのページにコードを貼り付けます。

iframe コード例

<token> を埋め込みトークンに置き換えます。URL は https://bazaarlink.ai/embed/insights/<token> です。秘密として扱ってください。

<iframe src="https://bazaarlink.ai/embed/insights/<token>" width="100%" height="720" style="border:0"></iframe>

許可ドメインと CSP

正確な https オリジン（スキーム、ホスト名、ポート）を指定します。パスやワイルドカードは使いません。CSP frame-ancestors は登録されたオリジンでのみ埋め込みを許可します。https://portal.example.com を許可し https://other.example.com を許可していない場合、後者の iframe はブラウザにブロックされます。

有効期限と失効

トークンはハッシュ化して保存され、いつでも失効できます。失効すると URL は直ちに使えなくなります。期限切れのトークンもアクセスできません。退職者が出たら関連トークンを失効してください。

レート制限

トークンごとにリクエスト数を制限します。既定値は毎分 60 回で、設定で変更できます。無制限のデータ配信ではありません。

更新頻度とデータの鮮度

データは時間単位の利用集計です。ページは約 5 分ごとに更新されるため、リアルタイムより最大約 1 時間と更新間隔分遅れる場合があります。表示される「集計時点」を確認してください。

閲覧できる情報

選択した範囲の顧客向け価格による支出、節約額の推移、モデル名、リクエスト数を表示します。URL を持つ人は許可ドメインから閲覧できます。URL はパスワードと同様に保護してください。

読み取り専用

埋め込みトークンではモデルや API エンドポイントを呼び出せません。埋め込みインサイトとそのデータエンドポイントの読み取り専用です。ページは no-store と no-referrer を使用します。

高度なデータアクセス

GET https://bazaarlink.ai/api/embed/insights

以下の URL に GET リクエストを送り、Authorization ヘッダーで “Bearer” 方式の <embed token> を指定します。読み取り専用で変更される可能性があります。v1 で正式にサポートする表示方法は iframe です。

よくある質問