跳到主要内容

2 篇博文 含有标签「verification-result」

查看所有标签

验证文档更新

我们已更新验证文档，改进了方法字段描述并澄清了指导。

新功能​

Verification Result 文档​

更新了 Verification.Result Webhook 文档:

  • ageCategory 指导: 明确了 PASS 状态时 ageCategory 始终存在，应将其用于访问控制决策，而不是使用原始年龄值
  • 方法字段更新:
    • 从方法字段列表中移除了 self-confirmation 和 email-confirmation
    • 更新了 age-estimation-scan 的描述，表明它是返回年龄范围的面部年龄估计扫描（无 DOB）

更新的文档​

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用于访问控制。仅将其用于分析、日志记录或信息目的。