跳到主要内容

FAIL状态Webhook事件现在包含ageCategory

我们已更新Verification.Result Webhook事件，当年龄数据可用时，在FAIL状态事件中包含ageCategory字段。

新功能​

FAIL状态事件中的ageCategory​

ageCategory字段现在包含在Verification.Result Webhook事件的FAIL状态中，当满足以下条件时：

  • failureReason为age-criteria-not-met
  • 年龄数据可用（age.low和age.high都存在）

这提供了更完整的用户年龄类别信息，即使由于年龄标准未满足而导致验证失败，也能在保持明确访问控制边界的同时，实现更好的分析和日志记录。

文档更新​

Verification.Result文档已更新以反映此更改：

  • 字段表：更新描述以澄清FAIL状态时ageCategory何时存在
  • 主要差异表：澄清Webhook事件与API端点中ageCategory何时存在
  • FAIL状态字段存在规则：更新为在特定条件下将ageCategory显示为"有时包含"
  • 完整字段矩阵：更新为在Webhook的FAIL状态中将ageCategory显示为"sometimes²"
  • 示例负载：在FAIL状态示例中添加ageCategory以演示新行为
  • 实现检查清单：更新了处理FAIL状态中ageCategory的指导
  • 实现说明：澄清了PASS和FAIL两种状态中ageCategory的行为

重要提示​

  • 访问控制：即使FAIL状态事件中存在ageCategory，也永远不要将其用于访问控制决策。始终使用status字段来确定访问权限。
  • 一致性：此更新适用于Webhook事件和API端点响应
  • 语言支持：所有语言版本（英语、日语、简体中文和韩语）已更新

下一步​

  • 查看更新后的Verification.Result文档
  • 如果需要，更新您的集成以处理FAIL状态事件中的ageCategory
  • 请记住：当状态为FAIL时，即使字段存在，也永远不要将ageCategory用于访问控制。仅将其用于分析、日志记录或信息目的。