Webhook

グループの Settings ページを開き、Webhooks タブをクリックします。ここで、グループのすべての Webhook 設定を管理します。

「Webhook の作成」 をクリックし、わかりやすい名前とターゲット URL を入力し、21 の使用可能なイベント タイプからサブスクライブするイベントを選択します。

Webhook は、7 つのカテゴリにわたる 21 のイベント タイプをサポートします。統合に必要なイベントのみをサブスクライブします。

すべての Webhook 配信には HMAC-SHA256 署名が含まれているため、ペイロードが Balla Stats からのものであることを確認できます。各配信には次のヘッダーが含まれます。

署名を検証するための Node.js の例を次に示します。

const crypto = require('crypto');

function verifySignature(payload, signature, secret) {
  const expected = crypto
    .createHmac('sha256', secret)
    .update(payload)
    .digest('hex');
  return crypto.timingSafeEqual(
    Buffer.from(signature.replace('sha256=', '')),
    Buffer.from(expected)
  );
}

「テスト」 ボタンをクリックして、テスト イベントをエンドポイントに送信します。配信結果を表示して、エンドポイントが正しく受信および処理していることを確認します。

各 Webhook の完全な配信履歴を表示します。各ログ エントリには、配信ステータス (DELIVERED、FAILED、RETRYING)、HTTP ステータス コード、応答時間、およびエラー メッセージが表示されます。

失敗した配信は、指数バックオフを使用して自動的に再試行されます。デフォルトの設定は 3 回の再試行で、遅延は増加します。

10 回連続失敗 が発生すると、リソースの無駄を防ぐために Webhook が自動的に無効になります。エンドポイントの問題を解決した後、手動で再度有効にすることができます。

Webhook シークレットが侵害された場合は、すぐに再生成してください。署名検証が引き続き機能するように、次回の配信前に受信エンドポイントを新しいシークレットで更新します。