跳到主要内容

15 篇博文 含有标签「documentation」

查看所有标签

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

我们更新了文档，以阐明 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，并对锁定横屏的应用使用默认浏览器方法

Redirect URL for Automatic age assurance flows

/age-gate/check now accepts a redirect URL that k-ID navigates to once an Automatic age assurance challenge completes. This is intended for top-level browser handoffs (such as a mobile webview that bounces out to k-ID and back) where an iframe-based result handler isn't an option.

What's new​

  • options.playerAgeAssurance.redirectUrl. Pass an http(s) URL or a custom-scheme mobile deeplink (for example myapp://age-gate/return) on /age-gate/check. After the player completes or dismisses the CHALLENGE_AGE_GATE_AGE_ASSURANCE flow, k-ID redirects to that URL with challengeId, productId, sessionId (on PASS), and status (PASS or FAIL) appended as query parameters. Existing query parameters on the URL are preserved.
  • Scope. The option is only honored for CHALLENGE_AGE_GATE_AGE_ASSURANCE. CHALLENGE_PARENTAL_CONSENT is unaffected and continues to return through the trusted-adult flow.
  • Confirm outcomes server-side. The redirect query parameters are a UX hint. Treat the Challenge.StateChange webhook or /challenge/get-status as the source of truth before granting access.

Documentation​

面向 AI 编码代理的官方 k-ID Agent Skills 套件

k-ID 现已发布官方 Agent Skills 套件 — 一组小巧、可组合的指令包,用于教 AI 编码代理如何在 k-ID 支持的所有司法管辖区（美国 COPPA、欧盟 GDPR-Kids、英国 AADC、英国《在线安全法》、巴西 ECA Digital、澳大利亚《在线安全法》/社交媒体最低年龄等）正确集成 k-ID。它适用于 35 多种 AI 编码工具,包括 Claude Code、Cursor、OpenAI Codex、GitHub Copilot 和 Gemini CLI。

新增内容​

  • 八个聚焦技能 端到端地覆盖 k-ID 集成面：年龄门、家长同意、年龄验证与年龄保证（包括高风险权限的 verifiedAgeThreshold 流程）、会话与权限、webhook,以及针对服务端信任边界和移动端/原生的横切性辅助技能。
  • 跨司法管辖区设计。同一套技能即可支持 COPPA、GDPR-Kids、英国 AADC、英国 OSA、巴西 ECA Digital 和澳大利亚《在线安全法》的集成 — 司法管辖区差异通过 Compliance Studio 在服务端配置,而不是在客户端代码中分支。
  • 一键安装：Claude Code 通过插件市场一条命令完成；其他兼容工具使用一行 git clone。
  • 开放标准 — 技能遵循 Agent Skills 规范,可与任何兼容的代理一起使用,而不局限于单一厂商。
  • 文档优先契约 — 技能仅编码集成模式和已知陷阱,API 形状链接回本文档站,因此永远不会与 API 脱节。

试试​

了解更多​

AI 产品快速入门指南

针对 AI 特化型产品的全新快速入门指南现已上线，同时在 Compliance Studio 参考中新增了 AI 权限类别。

新功能​

  • AI 产品快速入门。 引导您完成 AI 产品的端到端集成：在 Compliance Studio 中配置 AI 权限、收集父母同意、控制 AI 功能、响应权限变更。
  • AI 权限类别。 权限参考现在列出了 AI 类别及其七个权限：ai-chat、ai-media-generation、ai-voice-mode、ai-memory、ai-companion-chatbot、ai-media-upload 和 ai-model-training。

文档​

速率限制文档

k-ID API 以及面向用户的年龄验证和家长同意流程的默认速率限制现已在专门的页面中提供。

新功能​

  • API 速率限制。 对 k-ID API 的调用按产品进行限制：生产模式下为 500 RPS，测试模式下为 10 RPS。超出限制的请求将返回 HTTP 429 Too Many Requests。
  • 年龄验证和家长同意流程速率限制。 面向用户的流程按产品进行限制：生产模式下为 100 RPS，测试模式下为 20 RPS。达到限制时，用户会看到流程内错误，提示其稍后再试（不会向您的服务器返回 429）。
  • 申请提升。 这些是默认值。如果您的产品需要更高的容量，请联系您的 k-ID 代表。
  • 更新了上线前检查清单。 CDK 和 AgeKit+ 上线前检查清单现在都明确提及速率限制，并链接到新页面，因为生产模式的上限明显高于测试模式。

文档​

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 视为不透明字符串，按返回原样展示或编码；不要依赖固定的路径或查询结构，其形式日后可能会变。

了解更多​

平台年龄信号文档

我们已发布 平台年龄信号 的端到端文档，说明 Apple iOS、Google Play、Xbox、Meta Horizon 与 k-ID 的年龄数据如何进入 k-ID、何时可以跳过年龄门，以及 已验证 与 未验证 信号如何影响高风险权限与年龄保障流程。

新功能​

CDK — 平台年龄信号​

  • 平台年龄信号 — 快速集成路径、API 地图、推荐请求顺序、POST /age-gate/check 如何使用平台信号、支持的平台与 已验证声明类型，以及已验证与未验证信号的行为说明。
  • 平台信号详情 — 各平台的字段形态、如何获取各原生信号、按接口的说明（get-requirements、check、get-default-permissions、session/get、get-platform-age-range、session/upgrade）、校验、年龄冲突以及 k-id 信号规则。

概念与相关文档​

  • 年龄信号 — 平台年龄信号与其他信号类型的关系，以及 PlatformAgeSignal 集成细节的查阅入口。
  • 高风险功能的年龄保障 与 权限 — 关于 verifiedAgeThreshold 与在年龄门通过已验证平台信号满足条件的交叉引用说明。

API 参考（OpenAPI）​

会话升级、AgeVerification 与 platformAgeSignal 的描述已与上文文档统一为 已验证平台信号 的表述。

文档​

浏览器和设备兼容性

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

新功能​

浏览器和设备兼容性​

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

新文档​