13 篇博文 含有标签「documentation」

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）的要求。它将我们各验证提供商的兼容性要求整合为单一参考。

新文档​

• 浏览器和设备兼容性

我们已补充 附加法律链接（Developer Details）及 Check age gate API 的 options 参数说明，便于在同意流程中展示平台相关法律文档（如 Xbox、PlayStation、Steam）。

新功能​

附加法律链接（Developer Details）​

在 Compliance Studio 的产品 Developer Details 标签页中，可添加在同意流程中显示的可选 附加法律链接：

• 标题与链接：本地化显示标题与 URL（与主法律文档相同的语言选项）。
• 变体 ID：调用 Check age gate API 时使用的标识符（如 xbox-tos、playstation-privacy-policy）。当始终显示为关时必填。
• 始终显示：开（默认）时，该链接在同意流程中始终显示。关时，仅当您的游戏在 options 中传入对应变体 ID 调用年龄验证 API 时才显示。

当游戏在多个平台分发且各平台需使用不同法律文档 URL 时可使用此功能。

Check age gate API — options 参数​

POST /api/v1/age-gate/check 的请求体现支持可选的 options 对象：

• termsOfServiceDocument：服务条款变体 ID（须与已配置的附加法律链接一致）。
• privacyPolicyDocument：隐私政策变体 ID（须与已配置的附加法律链接一致）。
• additionalLegalLinks：与服务条款和隐私政策一起显示的附加法律文档变体 ID 数组（每个须与已配置的附加法律链接一致）。

当创建挑战时，同意界面将显示所请求的法律链接，而非产品默认的 Privacy Policy 与 Terms of Service。

文档​

• Developer Details — 基本信息（含附加法律链接）
• Check age gate（请求体与 CheckAgeGateRequestOptions）

我们更新了年龄验证文档，补充了 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 将不再返回。

更新的文档​

• 年龄验证快速入门
• 瀑布流