添加物品 Webhook

阿哈尼姆提供一个集中的 webhook，通知您的游戏，根据玩家在游戏中心内的活动将物品计入到玩家帐户。 每当玩家进行需要物品计入的操作时，该 webhook 就会被触发。 本指南提供有关此 webhook 功能和设置的详细信息。

在以下情况下会触发此 webhook：

• 玩家在游戏中心购买物品
• 玩家在游戏中心兑换免费物品代码
• 玩家领取每日奖励或忠诚度计划奖励

每个警报都包含一个原因字段，用于说明物品计入的理由。

要求

要使用阿哈尼姆的item.add webhooks，您应按以下方式配置 webhook 服务器：

• HTTPS 端点，接受 POST 网络钩子请求。
• 监听由阿哈尼姆生成和签名的事件。
• 处理包含在 webhook 有效负载中的幂等性键，以防止处理重复的 webhooks。
• 将指定物品记入玩家账户。
• 使用 2xx 状态代码以发出信号表示成功处理，并使用 4xx 或 5xx 表示拒绝或错误。

配置

以下是用于处理阿哈尼姆 webhooks 的端点的函数模板，通知您的游戏进行物品计入：

当您的函数准备好后：

1. 让您的端点可用。
2. 通过选择相应的事件类型，在阿哈尼姆账户中注册您的端点 → 游戏 → Webhooks → 新 Webhook。

或者，您可以使用 Create Webhook API 方法在阿哈尼姆中注册您的端点。

事件数据架构

键	类型	描述
player_id	string	为玩家身份验证选择的唯一玩家 ID。
items	Item[]	要计入玩家账户的物品数组。
reason	string	触发 webhook 的可阅读理由。 示例：订单支付 ord_eCacAulggpY。
item_id	string	[已弃用] 由阿哈尼姆生成的物品 ID。
sku	string	[已弃用] 游戏和阿哈尼姆双方匹配的物品 SKU。

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