POST リクエストで行われ、重複排除用の一意なヘッダー X-BZ-Delivery を含み、信頼性を最大化するための段階的な再試行戦略を使用します。
利用可能なWebhookサービス
- Data Webhook Engine: 設定可能なフィルターとオプションのペイロード変換機能を備えた、リアルタイムのcalendarおよびシグナルデータ（決算、配当、レーティング、オプション取引、WIIMなど）。詳細なガイドは Data Webhook Engine を参照してください。
- 追加のWebhook設定はお客様のアカウント単位で行うことができます。特定のデータセットを有効化する場合、または新しいWebhook URLを登録する場合は、Benzingaの担当者までお問い合わせください。
インテグレーションフロー
1
エンドポイントとフィルターを共有する
外部から到達可能な HTTPS エンドポイントと、必要なデータタイプや地域フィルターを指定してください。Benzinga がそれらの設定で webhook を構成します。
2
インテグレーションをテストする
Test Webhook Delivery エンドポイントを使用して、webhook エンドポイントが正しく構成されており、配信を受信できることを確認してください。
3
配信を冪等的に処理する
JSON ペイロードをパースし、重複を回避するために
id と X-BZ-Delivery の値を使用し、受信確認として速やかに 2xx ステータスで応答してください。4
モニタリングと改善を行う
失敗、タイムアウト、リトライをログで追跡します。下流システムに新たな要件が発生した場合は、Benzinga の担当者と連携してフィルターやペイロード変換を調整してください。
ベストプラクティス
- Webhook エンドポイントには HTTPS と認証を使用します。
- レスポンスを 30 秒以内に返せるよう、処理は非同期で行います。
- 再試行時に冪等性を確保するため、処理済みの配信 ID を保存します。
- 本番配信に切り替える前に、本番以外のエンドポイントでテストします。