Webhook APIリファレンス

署名付き・少なくとも1回保証のイベント配信、履歴とリプレイに対応

送信先

認証が必要な10個のルートで、送信先の作成、一覧取得、詳細確認、更新、シークレットのローテーション、テスト、削除に加え、設定と配信履歴の読み取り、1件の配信のリプレイを行えます。送信先のフィルターは、アカウントで有効な国とデータファミリーの権利の範囲内に限られます。 Webhook送信先の上限は、Free が 1、Basic が 3、Pro が 10 です。

予測イベント

predictionsファミリーを含む送信先には、イベントの取引が停止するとprediction.event.closedを、イベントが決済または無効になるとprediction.event.settledを送信します。各通知はイベントごとに最大1回送信します。本文にはイベントのステータスが含まれますが、確率や勝利した選択肢は含まれません。

署名と再試行

x-narwhal-signature を、timestamp + "." + raw_body に対する HMAC-SHA256 として検証してください。配信は少なくとも1回行われます。永続的な処理が完了してから 2xx レスポンスを返し、配信 ID で重複を排除してください。

履歴とリプレイ

配信履歴には試行の状態とレスポンスステータスが記録されます。リプレイは、同じ不変のイベントに対して新しい配信を作成します。シークレットのローテーションには重複期間があり、受信側は通知された2つの署名のどちらでも検証できます。