📄️ 工作流程
下图显示了 k-ID 引擎工作流程的视图。API 调用在使用它们的工作流程点上被标识。
📄️ 管理会话
k-ID的`Session包含当前玩家和位置的权限和年龄状态的集合。每个玩家都需要一个活动的Session。游戏应咨询活动的Session`以确定游戏中的功能是启用还是禁用。
📄️ 获取玩家年龄
收集年龄的司法要求
📄️ 使用面部年龄估算进行年龄验证
k-ID 支持通过面部年龄估算来估计用户年龄。这需要使用 /age-assurance/create-verification-request API。
📄️ 年龄检查
如果需要年龄门槛，现在必须进行一次 /age-gate/check 的 API 调用，以确定下一步的工作流程。如果玩家的年龄低于发布者门户中为游戏配置的最低年龄，返回的 status 字段将为 PROHIBITED。此时，玩家应被阻止继续游戏。如果玩家提供了需要在当前地点获得可验证的家长同意的出生日期，则 status 字段的值将为 CHALLENGE，并且一个新的同意挑战的 ID 将在名为 challengeID 的字段中返回。此时，游戏必须要求玩家寻求家长同意。最后，如果 status 的值为 PASS，则玩家可以继续进入游戏。
📄️ 年龄验证申诉
当年龄验证检查失败或玩家希望对游戏为他们分配的年龄分类提出申诉时，他们可以创建一个年龄申诉流程。要发起年龄申诉，玩家必须被引导到家庭门户的年龄申诉 URL。在那里，他们可以使用其所在司法管辖区允许的方法（例如，提供照片 ID）来证明其年龄。
📄️ 寻求家长同意
如果 /age-gate/check 的 status 字段返回 CHALLENGE 值，响应中的 challengeId 字段包含 k-ID 引擎中 Consent Challenge 的 ID。此时应显示一个窗口，允许玩家寻求家长同意。
📄️ 使用会话权限
一旦用户通过了年龄门槛检查，无论是因为其年龄已符合要求，还是家长已授予同意，游戏即可获取该玩家当前所在司法管辖区的所有特定权限。这可以通过 /age-gate/check 调用的结果，当 status 字段为 PASS 时完成，或者如果会话已创建并缓存，可以调用 /session/get。
📄️ Webhooks
Webhooks 允许你订阅 k-ID 引擎中发生的事件，而不是通过轮询 API 来查看数据是否可用。
📄️ 请求新权限的同意
（这是一个路线图功能，并在API文档中标记为实验性）