高可用性

Webhook をデプロイする際には、高可用性が重要な考慮事項です。 Webhook が使用不可の場合、ユーザー・フローが失敗する可能性があります。

API の高可用性を確保するための業界標準の方法がいくつかあります。 IBM® Verify の Webhook エンジンでも、役立つ機能を提供しています。

複数の URL

管理者は、Webhook 構成の一部として複数の URL を定義できます。
  • これらの URL はラウンドロビン方式で使用でき、どの URL が使用されるかを制御する方法はありません。
  • 各 URL のエラー件数が維持されます。 URL が連続して失敗すると、その URL はローテーションから 5 分間、除外されます。

再試行

Webhook は URL を再要求しようとします。
  • Verify の Webhook エンジンは、接続エラーまたは受け入れ不可能状況コードを受信した場合に要求を再試行します。
  • 再試行が行われると、使用可能な場合は別の URL が使用されます。

Webhook の呼び出しと再試行の追跡

すべての Webhook 要求には、ヘッダー X-Webhook-ID が含まれます。 このヘッダーは、Webhook 呼び出しでの再試行を検出するために使用できます。 ヘッダーは、トランザクションが完了しても再試行が行われる場合に、インスタンスにとって重要になる場合があります。
注: 通知Webhookの呼び出しにおいて、この値は伝播されたイベントの `field` フィールド id と一致します。このフィールドは、events APIおよびdead-letters APIで使用できます。