新的会话和权限指南及文档更新
我们添加了一个全面的会话和权限管理指南,并更新了核心概念文档,添加了重要的说明。
新功能
新指南:管理会话和权限
我们添加了一个新的快速入门指南:管理会话和权限。本指南提供了以下步骤说明:
- 使用 Webhook 和会话比较检测权限更改
- 处理会话删除和撤销
- 向玩家传达权限更改
- 实现权限升级流程
- 了解挑战如何与会话相关
本指南对于需要随时间响应权限更改的任何集成都是必不可少的,例如当父母修改设置或玩家年龄增长时。
文档更新
会话文档
会话概念页面已更新,添加了重要说明:
- 会话 ID 持久性:玩家每个产品只有一个会话。会话 ID 在权限更改期间保持不变,但如果会话被撤销并再次完成同意流程,则会创建新的会话 ID。
- 会话删除行为:已删除的会话返回 HTTP 400,错误代码为
NOT_FOUND(不是 404)。这是有意的—已删除的会话应被视为从未存在过。 - 年龄升级更改:年龄升级事件不会触发 Webhook 通知。您必须使用会话比较来检测这些更改。
权限文档
权限概念页面已增强,包含:
managedBy字段更改:明确说明managedBy可能随时间变化(例如,当玩家年龄增长时从GUARDIAN变为PLAYER)。- 玩家管理的权限:当玩家通过
/session/upgradeAPI 请求启用PLAYER管理的权限时,它会自动启用而不会创建挑战。 - 权限升级内容:权限升级文档已合并到权限页面,以便更好地发现。
更改内容
合并的文档
- 权限升级概念页面已合并到权限页面。所有引用已更新为指向新位置。
后续步骤
- 查看新的管理会话和权限指南
- 确保您的集成正确处理会话删除(HTTP 400,错误代码为
NOT_FOUND)
如果您对这些更新有任何疑问或需要集成方面的帮助,请随时联系我们的支持团队。