高可用性
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で使用できます。