兑换码 Webhook

Aghanim 提供一个已兑换码的webhook，用于在玩家使用免费物品兑换码时通知您的游戏，提供该事件的详细信息。

此 webhook 通过已兑换码事件激活，可在游戏 → Webhooks中选择。

警告

要将游戏内物品记入玩家账户，请使用item.add webhook。 当item.add不足时，优惠券已兑换 webhook 旨在提供详细的数据。

需求

要使用 Aghanim 的已兑换码 webhooks，您应按如下方式配置 webhook 服务器：

• HTTPS 端点，接受 POST webhook 请求。
• 监听由 Aghanim 生成和签名的事件。
• 响应 2xx 状态码以表示处理成功，响应 4xx 或 5xx 表示拒绝或错误。

配置

1. 为coupon.redeemed webhook 处理开发一个功能。
2. 使您的端点可用。
3. 在 Aghanim 账户中注册您的端点→ 游戏 → Webhooks → 新建 Webhook 通过选择相应的事件类型。

或者，您可以使用创建 WebhookAPI 方法在 Aghanim 中注册端点。

事件数据模式

键	类型	描述
player_id	string	用于玩家身份验证的唯一玩家 ID。
coupon	Coupon	包含兑换码数据的优惠券对象。
item	Item	包含物品数据的物品对象。

优惠券对象

键	类型	描述
code	string	兑换代码。
sku	string	兑换码使用时提供的免费物品 SKU。
redeemed_at	number	代码使用的 Unix 纪元时间。

需要帮助吗？
联系我们的集成团队 integration@aghanim.com