15 篇博文 含有标签「documentation」

我们更新了文档，以阐明 k-ID 在移动端的最佳集成方式：对于年龄门控和同意步骤，原生构建的 UX 能为玩家提供最无缝的体验；而年龄验证和年龄保证 URL 等 Web 嵌入则通过系统浏览器组件显示。

新功能​

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

年龄门控和端到端小部件在移动端受到完全支持。对于年龄门控和同意步骤，我们鼓励使用自定义工作流原生构建 UX 并遵循 CDK UX 指南，以获得最贴合品牌的体验。

k-ID API 返回的年龄验证和年龄保证 URL 采用相同的方式显示。有关具体端点和挑战类型，请参阅移动应用指南。

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

移动应用指南已重新以年龄验证为中心，这是移动端最常见的 Web 嵌入：

• 所有示例（服务器请求、客户端获取、显示和回调处理）现在都使用来自 /age-verification/perform-access-age-verification 的年龄验证 URL
• 结果处理涵盖 Verification.Result DOM 事件以及通过 /age-verification/get-status 进行的服务器端确认

默认浏览器方法​

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

设备方向指南​

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

文档更新​

• 移动应用：重新以年龄验证为中心，并新增默认浏览器和设备方向章节
• CDK 嵌入式流程：新增端到端和年龄门控小部件的移动端显示指南
• CDK 概述：在集成方法比较中新增移动端指南
• CDK 自定义工作流：指出自定义工作流是移动应用的推荐方法
• 可验证父母同意 (VPC)：为这个基于小部件的指南新增移动端使用说明

后续步骤​

• 如果您在移动端集成，可以考虑使用自定义工作流和 CDK UX 指南原生构建您的年龄门控和同意 UX，以获得最无缝的体验
• 在显示验证 URL 时，对锁定横屏的应用使用默认浏览器方法

/age-gate/check 现在接受一个重定向 URL，k-ID 会在自动年龄保证挑战完成后跳转到该地址。此功能适用于无法使用基于 iframe 的结果处理程序的顶层浏览器切换场景（例如跳转到 k-ID 再返回的移动 webview）。

新功能​

• options.playerAgeAssurance.redirectUrl。 在 /age-gate/check 上传入 http(s) URL 或自定义方案的移动深层链接（例如 myapp://age-gate/return）。当玩家完成或关闭 CHALLENGE_AGE_GATE_AGE_ASSURANCE 流程后，k-ID 会重定向到该 URL，并将 challengeId、productId、sessionId（PASS 时）和 status（PASS 或 FAIL）作为查询参数附加。URL 上现有的查询参数会被保留。
• 范围。 该选项仅对 CHALLENGE_AGE_GATE_AGE_ASSURANCE 生效。CHALLENGE_PARENTAL_CONSENT 不受影响，仍通过可信成人流程返回。
• 在服务器端确认结果。 重定向查询参数只是 UX 提示。在授予访问权限之前，请将 Challenge.StateChange webhook 或 /challenge/get-status 作为可信来源。

文档​

• 年龄门控 → 挑战后重定向
• /age-gate/check API 参考
• Challenge.StateChange webhook

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 编码代理集成 了解按工具的安装矩阵和使用指南。
• 访问仓库 github.com/kidentify/skills。

了解更多​

• 与 AI 编码代理集成
• Agent Skills 规范
• Agent Skills 客户端展示
• API 概述

针对 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。

文档​

• AI 产品快速入门
• 权限

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+ 上线前检查清单现在都明确提及速率限制，并链接到新页面，因为生产模式的上限明显高于测试模式。

文档​

• 速率限制
• 错误处理
• CDK 上线前检查清单
• AgeKit+ 上线前检查清单

今天的发布新增了两项 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 日 执行日前完成必要的配置更新。

文档​

• 验证方法：模拟和真实提供商
• 成人验证 → 验证方法排序
• Compliance Guides → 2026 COPPA 规则修订

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

新功能​

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

文档​

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

年龄验证创建响应（来自 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）的要求。它将我们各验证提供商的兼容性要求整合为单一参考。

新文档​

• 浏览器和设备兼容性