跳到主要内容

7 篇博文 含有标签「age-verification」

查看所有标签

小部件与年龄验证的移动集成指南

我们更新了文档，以阐明 k-ID 在移动端的集成方式：原生构建年龄门控和同意流程，并将 Web 嵌入保留给年龄验证 URL。

新功能​

年龄门控和端到端小部件的移动端指南​

年龄门控和端到端小部件不推荐用于移动应用。在移动端，请使用自定义工作流并原生构建年龄门控和同意 UX 元素，遵循 CDK UX 指南。

移动端唯一支持的 Web 嵌入是 k-ID API 返回的年龄验证和年龄保证 URL。有关具体端点和挑战类型，请参阅移动应用指南。

重新编写的移动应用指南​

移动应用指南已重新以年龄验证为中心，这是移动端仍推荐使用 Web 嵌入的流程：

默认浏览器方法​

在移动端实现方法下，我们记录了默认外部浏览器方法。它在 Android（Intent.ACTION_VIEW）和 iOS（UIApplication.open）上均可使用，完全支持 AgeKeys，并通过 redirectUrl 回调将焦点返回到您的应用。

设备方向指南​

年龄验证在竖屏方向下效果最佳。由于应用内浏览器界面会继承您应用的方向锁定，锁定横屏方向的应用应在默认外部浏览器中打开验证 URL。浏览器管理自己的方向，因此用户可以旋转到竖屏，并且当流程完成时 redirectUrl 回调会将他们返回到您的应用。

文档更新​

后续步骤​

  • 如果您在移动端集成，请使用自定义工作流和 CDK UX 指南原生构建您的年龄门控和同意 UX
  • 在移动端仅嵌入年龄验证 URL，并对锁定横屏的应用使用默认浏览器方法

信用卡专用年龄验证端点

现在提供了专用端点 /age-verification/perform-credit-card-verification，用于仅以信用卡作为方式执行年龄验证，与现有的单一方式端点（ID、AgeKey、ConnectID）并列。

新功能​

  • POST /age-verification/perform-credit-card-verification。 绕过自动方式选择，仅使用信用卡验证用户。它接受与其他单一方式端点相同的请求结构（jurisdiction、subject、criteria 以及可选的 options.redirectUrl / options.locale），并返回 id、url 和 shortUrl。
  • 成人（18 岁以上）保证。 信用卡验证是一种成人保证信号，而非精确的年龄估计。它最适合卡片所有权仅限成人的司法管辖区。
  • 状态和结果不变。 照常轮询 /age-verification/get-status 或处理 Verification.Result webhook。结果会将 credit-card 报告为验证 method。

文档​

Mock Providers 切换、验证方法排序与 COPPA 2026 指南

今天的发布新增了两项 Compliance Studio 功能，以及针对 COPPA 2026 规则修订的新开发者指南。

新功能​

  • Mock Providers / Real Providers 切换。 在测试模式下运行的验证流程现在会显示一个 TEST MODE 工具栏，带有在 Mock Providers（默认）和 Real Providers 之间切换的开关。Mock Providers 提供内置模拟器，支持提交角色（Adult、Teen、Child 或 Passes / Fails Age Check）、输入自定义年龄范围或出生日期，以及模拟 Inconclusive 或 Fraudulent 失败。提交通过与真实提供商相同的服务器路径流转，因此 Webhook、会话和 DOM 事件的行为完全一致。
  • 验证方法排序。 Assurance and Verification 标签页上每个已启用的方法现在都有一个拖动手柄。拖动方法以更改在 Family Connect 小部件中向用户展示的顺序，使用 Reset to default order 恢复到 k-ID 默认顺序，或通过 Market Specific Rules 为每个市场应用不同的顺序。
  • 新的 Compliance Guides 部分。 一个全新的顶级文档部分今日上线，用于发布合规指南。首个条目是 2026 COPPA 规则修订，该指南引导受 COPPA 约束的运营者在 2026 年 4 月 22 日 执行日前完成必要的配置更新。

文档​

可将验证方法配置为回退选项

现在除了启用或禁用之外，还可以将产品中每种验证方法配置为 仅作为备选。

新功能​

  • 仅作为备选：处于该设置的验证方法，仅当用户已尝试另一种验证方法，且该尝试未产生年龄信号（未得出明确的年龄判定）时才会提供；不会出现在初始方法列表中。
  • 适用场景：当较轻的方式无法得到验证结果时，再提供更强或替代方式，而无需在一开始展示全部选项。

文档​

  • 成人验证: 如何按方法启用、禁用或设置 仅作为备选
  • 验证方法: 验证行为概述，含 仅作为备选 说明框

年龄验证 API 响应中的短 URL 字段

年龄验证创建响应（来自 POST /age-verification/perform-access-age-verification 及其他 perform-* 年龄验证端点）现在除 id 与 url 外，还会返回 shortUrl。

新功能​

  • 短链接：shortUrl 是较短链接，会重定向到与完整 url 相同的验证体验。当查询字符串过长不便使用时（例如生成二维码，或用户在另一台设备上完成验证），可使用它。
  • 完整 URL 不变：会话 JWT 仍位于完整 url 的 token 查询参数中。请勿自行缩短或重新构造该 URL。
  • 不透明值：将 shortUrl 视为不透明字符串，按返回原样展示或编码；不要依赖固定的路径或查询结构，其形式日后可能会变。

了解更多​

浏览器和设备兼容性

我们已在文档中新增 浏览器和设备兼容性 页面，方便您快速查看我们年龄验证流程支持的浏览器和设备。

新功能​

浏览器和设备兼容性​

新页面列出桌面端和移动端的最低浏览器版本，以及嵌入式浏览器（iOS 的 ASWebAuthenticationSession、Android 的 Chrome Custom Tabs）的要求。它将我们各验证提供商的兼容性要求整合为单一参考。

新文档​

验证 URL 有效期与 get-status 文档

我们更新了年龄验证文档，补充了 URL 有效期、过期 URL 处理及状态查询说明。

新功能​

  • URL 有效期：验证 URL 自创建起 2 周内有效。过期时间位于 JWT 的 token 查询参数中，可使用标准 exp 声明判断 URL 是否仍有效。
  • 过期 URL：使用保存的验证 ID 调用 /age-verification/get-status。若未找到该验证，请创建新的验证。
  • 不依赖 URL 查询状态：使用验证 ID 调用 get-status 可随时查询状态（例如 URL 过期后或未收到 webhook 时）。
  • 保留期限：超过 2 周仍为 PENDING 的验证会被删除，get-status 将不再返回。

更新的文档​