> ## Documentation Index
> Fetch the complete documentation index at: https://docs.benzinga.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhook 概要

> 堅牢でフィルタリング可能な webhook を使って、Benzinga のマーケットデータをお客様のシステムへプッシュ配信します。

Benzinga の webhook は、リアルタイムのマーケットイベントをお客様の HTTP エンドポイントに直接送信することで、ポーリングの必要をなくします。配信は JSON 形式の `POST` リクエストで行われ、重複排除用の一意なヘッダー `X-BZ-Delivery` を含み、信頼性を最大化するための段階的な再試行戦略を使用します。

<div id="available-webhook-services">
  ## 利用可能なWebhookサービス
</div>

* **Data Webhook Engine**: 設定可能なフィルターとオプションのペイロード変換機能を備えた、リアルタイムのcalendarおよびシグナルデータ (決算、配当、レーティング、オプション取引、WIIMなど) 。詳細なガイドは [Data Webhook Engine](./webhook-engine) を参照してください。
* 追加のWebhook設定はお客様のアカウント単位で行うことができます。特定のデータセットを有効化する場合、または新しいWebhook URLを登録する場合は、Benzingaの担当者までお問い合わせください。

<div id="integration-flow">
  ## インテグレーションフロー
</div>

<Steps>
  <Step title="エンドポイントとフィルターを共有する">
    外部から到達可能な HTTPS エンドポイントと、必要なデータタイプや地域フィルターを指定してください。Benzinga がそれらの設定で webhook を構成します。
  </Step>

  <Step title="インテグレーションをテストする">
    [Test Webhook Delivery](/ja/api-reference/webhook_api/test-webhook-delivery) エンドポイントを使用して、webhook エンドポイントが正しく構成されており、配信を受信できることを確認してください。
  </Step>

  <Step title="配信を冪等的に処理する">
    JSON ペイロードをパースし、重複を回避するために `id` と `X-BZ-Delivery` の値を使用し、受信確認として速やかに 2xx ステータスで応答してください。
  </Step>

  <Step title="モニタリングと改善を行う">
    失敗、タイムアウト、リトライをログで追跡します。下流システムに新たな要件が発生した場合は、Benzinga の担当者と連携してフィルターやペイロード変換を調整してください。
  </Step>
</Steps>

<div id="best-practices">
  ## ベストプラクティス
</div>

* Webhook エンドポイントには HTTPS と認証を使用します。
* レスポンスを 30 秒以内に返せるよう、処理は非同期で行います。
* 再試行時に冪等性を確保するため、処理済みの配信 ID を保存します。
* 本番配信に切り替える前に、本番以外のエンドポイントでテストします。