跳到主要内容

通过 /session/delete 的新模式保护必需产品依赖关系

/session/delete 现在可以保护(或一并清理)依赖于被删除会话的其他产品。

新功能

  • POST /session/deleteessentialDependencies 当一个产品被配置为其他产品的*必需(essential)*产品时,以前删除其会话会静默地留下依赖产品的会话,使它们失去所依赖的同意基础。新字段让你可以选择替代行为,在默认撤销和 hardDelete 两种路径上均有效。
  • block 拒绝删除,而不是孤立依赖产品。 当玩家仍持有依赖被删除产品的活跃产品时,调用返回 ESSENTIAL_DEPENDENTS_EXIST 并列出依赖产品的 ID。无需启用。
  • cascade 会同时删除依赖的会话,然后删除指定的会话,每个会话都有自己的 Webhook 通知,硬删除时还有各自的删除记录。由于它会删除你未指定的会话,此模式按开发者选择加入(未启用时发送会返回 FEATURE_DISABLED),并且需要服务器端 API 密钥而非客户端访问令牌。
  • 所有现有调用均不受影响。 省略该字段或发送 ignore 时,/session/delete 的行为与以往完全一致,并且永远如此。这是一项稳定的可选功能,而不是默认行为变更的前奏。

文档