アウトバウンド Webhook

プロ プランのサーバーは、メンバーがレベルアップするとリアルタイムの POST リクエストを受信できるため、Zapier、Make.com、または独自のバックエンドとの統合が可能になります。

プロ プランのみ

ペイロードの例

{ "イベント": "レベルアップ", "ギルドid": "987654321", "ユーザーID": "123456789", "ユーザー名": "アリス", "old_level": 41、 "新しいレベル": 42、 "total_xp": 176400、 "xp_curve": "標準", "タイムスタンプ": "2026-06-04T12:00:00Z" }

署名の検証

すべてのペイロードは HMAC-SHA256 で署名されます。 X-Xponent-Signature ヘッダーを HMAC-SHA256(payload_body, your_webhook_secret) に対して検証して、信頼性を確認します。

再試行ポリシー

指数関数的バックオフ (1 秒、5 秒、25 秒) による 3 回の自動再試行。 10 回連続して失敗すると、Webhook は自動的に無効になり、サーバー所有者に DM 経由で通知されます。