公共接口和导出格式规范

本文档定义了机器可读对象、验证规则和访问边界 公共接口和导出格式规范 在好味优选工程标准体系中的评审方法与控制要求。

本文件适用于以下方法明确规定的要求、决定、记录、控制与输出： 公共接口和导出格式规范。星级适用范围和排除范围由以下机构控制 GTA-STD-100；本文件不得增加其他评定维度。这里规定的操作前提会影响评审是否有效，但不构成产品认证。

数据与发布负责人 负责管理 GTA-DATA-004； 标准负责人 负责批准本文件。规范性用语、受控术语、稳定的条款标识、政策常量及生成内容，应依据 GTA-GOV-002, GTA-GOV-005及受控登记册进行解释。

公共接口可以被实现为静态资源、应用程序接口或两者。实现形式不应改变资源标识、授权内容、固定版本不变性或活动表示和版本特定表示之间的区别。

公共结果字段不得包含盲码、样本保管详细信息、评审员标识符、原始响应、个人观察、冲突声明、专业确认投票、内部原因代码、非公开结果或未发布的审查证据。

资源请求应通过稳定身份来解决。仅当该属性是公共的时，集合可以按文档族、文档类型、主题、类别、授权星级或受控术语进行过滤。除非接口明确标识另一个操作符，否则过滤器应是连接的。不支持的过滤器将返回错误；不应该被默默地忽视。

默认文档排序应遵循受控登记册。需求搜索结果应使用具有稳定身份的确定性相关性排序作为最终的决胜局。星级结果集合应使用显式声明的确定性顺序和不透明的连续游标。游标应绑定到集合标识、过滤器集、排序规则和表示的版本，以便以后的版本不能默默地更改正在进行的遍历。

搜索应索引正式的英文标题、标题、要求标识符、授权发布的正文、首选受控术语和批准的检索同义词。同义词可以改善发现，但不得取代显示结果或引用文本中的受控术语。

成功的结构化响应应识别资源、表示版本、可见性、内容完整性值和规范关系。收集响应还应识别所应用的过滤器、确定性顺序、已知的结果计数以及适用的连续状态。

活动资源可以在授权发布后重新生效。固定版本资源应使用不可变缓存，并应保留相同的内容完整性值。撤销的活动路由不会删除其固定版本记录；对该记录的访问应遵循授权状态和可见性规则。

文件导出应标识受控文件编号、正式标题、版本、状态、语言、固定版本路径、条款锚点和内容完整性值。 Markdown、结构化数据、阅读器 HTML、打印和引文表示应从同一授权对象生成，并应保留需求标识、规范语言、表格、注释和关系目的地。

引文应解析为文件或稳定条款锚。对活动路线的引用应显示所代表的版本。旨在支持持久主张的引文应使用固定版本途径。导出包应包含足以验证每个包含的资源属于同一授权版本的清单和完整性值。

可访问性元数据是表示合同的一部分。阅读器和导出输出应保留标题顺序、表格标题关系、描述性标签、替代文本、键盘可操作目标以及任何非文本内容的等效文本。

符合 公共接口和导出格式规范 需要证据，包括模式结果、对象标识、关系检查、权限事件和重建测试。每个适用的记录 GTA-DATA-004 要求应允许在不依赖未记录的解释的情况下进行重建。

根据以下内容创建的证据 GTA-DATA-004 应使用稳定的标识符、不可变的事件序列号和机器事件时间戳。更正只能是追加的。不符合项应将受影响的对象置于不可释放状态，直到记录其后果和授权处置。角色组合仍须遵守强制分离规则。