跳到主要内容

玩家更新 Webhook

当玩家的档案在游戏中心更新时，会触发player.update webhook。此事件对于更新游戏中的玩家信息非常有用，例如玩家的昵称、电子邮件或头像。

要求

要使用 Aghanim 的玩家更新 webhooks，您应配置 webhook 服务器如下：

HTTPS端点，接受POST webhook请求。
监听由 Aghanim 生成并签名的事件。
使用接收到的内容触发移动推送的显示。
在成功接收和处理 webhook 后返回 2xx 状态码，拒绝或错误时返回 4xx 或 5xx 状态码。

配置

开发用于 player.update webhook 处理的功能。
使您的端点可用。
在 Aghanim 帐户中注册您的端点 → 游戏 → Webhooks → 新建 Webhook，选择玩家更新事件类型。

配置移动推送活动的指南

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

事件数据模式

键	类型	描述	必需？
`player_id`	`string`	用于玩家身份验证的唯一玩家 ID。	是
`name`	`string`	玩家的昵称。	否
`email`	`string`	玩家的电子邮件地址。	否
`avatar_url`	`string`	玩家的头像 URL。	否

示例Webhook响应：

{
  "status": "ok"
}

失败响应示例：

返回200状态码和以下JSON响应：

{
  "status": "error",
  "code": "not_found",
  "message": "玩家未找到"
}

可能的错误代码列表：

not_found：未找到玩家。
invalid_signature：签名无效。
validation_error：请求数据无效。

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

要求
配置