メインコンテンツへスキップ

概要

Benzinga Widgets では、プレミアム機能やリアルタイムデータにアクセスするには認証が必要です。認証はウィジェットの URL に埋め込まれた API トークンによって行われ、シームレスな統合を維持しながら金融データへの安全なアクセスを実現します。

APIトークンの取得

Benzinga Widgetsをすべての機能で利用するには、次の手順を実施してください。
  1. Benzingaに連絡: [email protected] に連絡して、ウィジェット用のAPIトークンを取得します
  2. ライセンス契約: ウィジェットへのアクセスに必要なライセンス手続きを完了します
  3. 認証情報の受領: ウィジェットの認可に使用する、あなただけのAPIトークンが発行されます

トークンの利用方法

ベーシック認証

ウィジェットのURLの token パラメータでAPIトークンを指定します。
<iframe
    frameBorder="0"
    height="600"
    width="100%"
    src="https://widgets.benzinga.com/embed/chart/AAPL?token=YOUR_API_TOKEN&timeframe=6m&exchange=NASDAQ"
></iframe>

ベストプラクティス

ユーザーが閲覧できるクライアントサイドのコード内に API トークンを絶対に公開しないでください。 ウィジェットは公開ウェブサイトへの埋め込みを前提としていますが、可能な限りサーバーサイドでトークン管理を実装する必要があります。
推奨アプローチ:
  • サーバー上でトークンを環境変数として保持する
  • トークンを含めたウィジェットの URL をサーバーサイドで生成する
  • セキュリティ強化のために URL 署名やトークンローテーションを利用する

トークン管理

セキュリティ上の考慮事項

  • トークンを秘密に保つ: トークンをバージョン管理システムにコミットしないでください
  • 利用状況を監視する: ウィジェットの読み込み回数を追跡して、不正利用を検知できるようにしてください
  • トークンをローテーションする: 定期的にBenzingaから新しいトークンをリクエストしてください
  • ドメイン制限: Benzingaのサポートと連携して、許可するドメインを設定してください

レート制限

Widget API トークンには、ライセンス契約に基づいたレート制限が適用されます。
  • Standard ティア: 1日あたり最大10,000回のウィジェット読み込み
  • Premium ティア: 1日あたり最大100,000回のウィジェット読み込み
  • Enterprise ティア: 契約内容に基づき個別に設定

トラブルシューティング

一般的な認可エラー

ウィジェットに「Unauthorized」というエラーが表示される場合:
  • URL にトークンが正しく含まれているか確認する
  • トークンの有効期限が切れていないか確認する
  • 許可されたドメインからアクセスしていることを確認する
データが更新されない場合:
  • 利用中のライセンスにリアルタイムデータへのアクセス権が含まれているか確認する
  • トークンに必要な権限が付与されているか確認する
  • レート制限を超過していないか確認する

サポートを受けるには

認証・認可に関する問題や質問がある場合は、次の情報を添えてお問い合わせください。
  • メール: [email protected]
  • ウィジェットの URL 構造(トークン部分を伏せたもの)を含めてください
  • 発生している具体的なエラーや動作の内容を記載してください

次のステップ

認証が完了したら、利用可能なウィジェットオプションを参照し、金融データの表示をカスタマイズしてください。