验证器检查什么
验证器工作台根据已发布的配置文件模式和注册表支持的 UAI-1 期望检查候选 UAI 消息。
- 已发布消息系列的架构对齐。
- 针对注册表进行标识符、配置文件和命名空间验证。
- 可审计交换记录的来源、完整性和日志记录检查。
- 一致性失败时的可预测问题报告。
- 检测偏离已声明公共结构的消息。
一致性结果意味着什么
一致性结果是机器可读的证据,表明候选消息已根据当前公共记录进行检查。它应该适用于审查、发布门、回归检查和审计证据。
当前的公众合规态势
通过的验证器结果是当前的公开证据,表明消息与审核时发布的记录一致。它本身并不是认证徽章、合作伙伴指定,也不是保证未来的修订将保持一致而无需重新运行检查。
- 使用相同的已发布的 例子 当配置文件、模式、验证器行为或实现代码发生更改时,将测试样例作为回归基线。
- 当面向发布的行为发生变化时重新导出结果,以便公共证据保持最新状态。
通过的结果可以让你做什么,不能让你做什么
- 支持: 声称已审查的消息与验证时发布的公共记录一致。
- 不支持: 超出所附实施记录的认证、合作伙伴批准、永久兼容性或一般运行时支持的声明。
- 在公众支持之前需要更多: 发布数据包、实施轨道记录和发布轨迹条目,说明当前所有者、范围和迁移状态。
团队在部署之前应如何使用验证器
发布前的证据清单
- 记录验证过程中使用的配置文件标识符、模式路由、注册表句柄和示例装置。
- 将导出的一致性结果与实施包或运行时发行说明一起保留。
- 比较警告和失败,以便软漂移不会成为未记录的兼容性更改。
- 链接来自相关实施轨道、变更日志条目或公共新闻更新的证据包。
REST 端点期望
验证器页面是面向人的工作流程。 REST 验证路径是面向机器的 JSON POST 应通过发现元数据或 REST 目录来解析的端点,而不是将其视为可浏览的报告页面。
- 当人们需要夹具加载、并排审查和可下载的一致性记录时,请使用此页面。
- 使用自动化或客户端代码将候选消息 JSON 有效负载发送到验证端点。
- 当工具需要当前路径而不抓取页面时,请使用发现清单或 REST 目录。
- 不要将验证路径的直接浏览器 GET 视为验证器用户体验。
混凝土实时验证器表面
- 人性化工作台: 用这个 验证器 夹具加载、并排审查和可下载一致性记录的页面。
- 面向机器的验证路线:
/wp-json/uaix/v1/validate接受 JSONPOST对自动化和发布管道的请求。 - 支持机器可读记录路由:
/wp-json/uaix/v1/catalog,/wp-json/uaix/v1/schemas,/wp-json/uaix/v1/registry, 和/wp-json/uaix/v1/examples公开验证过程中使用的当前目录、模式、注册表和测试样例清单。
一致性证据如何成为公开发布记录
- 将导出的一致性结果附加到相关实施或包发布中,而不是将它们保留为私有本地检查。
- 使用 变更日志 当架构、配置文件或验证器行为更改影响迁移预期时。
- 使用 新闻 当通过或失败的版本需要面向公众的摘要时。
- 使用 参考资料与贡献者 当版本需要围绕其一致性证据的稳定发现和引用链接时。
验证器工作台
使用下面的公共工作台加载已发布的测试样例或根据当前配置文件模式验证候选 UAI 消息,然后在需要持久的机器可读报告时下载生成的一致性记录。
验证器
UAI-1 验证工作台
粘贴候选消息、加载已发布的夹具,选择有键或无键规范化模式,然后根据当前公开的 UAI-1 配置文件模式进行验证。验证器现在会在部署前检查更丰富的信封结构、异步任务状态记录、类型化错误细节、字段注册表对齐、跟踪上下文、交付过期时间、能力声明中的传输绑定、一致性级别以及信任策略提示。
一致性输入
验证 UAI 消息
使用下方已发布的夹具作为已知正确的起点,或粘贴来自你自己集成的候选负载。每次验证运行也可以导出为 `uai.conformance.result.v1` 记录,用于 CI 日志、发布证据或审计轨迹。
请将此页用作面向人工的验证流程。REST validate 路由是一个面向机器的 JSON 负载 POST 端点,而不是可浏览的报告页面。
下一步
继续 实施轨道 一旦候选人消息通过。使用 WordPress 发布轨道 用于出版和包装,或 .NET 桥接轨道 为了更深入的运行时集成,然后通过记录面向发布的更改 变更日志 和 新闻。