21、服务 API 标准化格式与元数据管理

服务 API 标准化格式与元数据管理

1. 标准化语义模型表达

在机器间传递内容含义时，需要将内部数据或对象模型表达为一致的外部语义模型。问题在于如何标准化这种传递方式，以及有哪些可用的格式和模式来将内部数据和流程模型表达为标准化语义模型。

解决方案是使用标准化词汇表，就像 API 消费者依赖标准化协议（如 HTTP）和消息格式（如 SIREN、Collection+JSON 等）一样。这意味着要以客户端能理解的标准格式列出所有数据属性和操作名称。需要有一个单一来源来涵盖 API 中可能出现的所有事物名称，这些值的集合可以覆盖某个主题或领域。

以下是几种可用的标准化词汇数据承载方式：
| 格式 | 描述 |
| ---- | ---- |
| RDF 格式（如 RDF/XML、Turtle、JSON - LD） | 较古老的解决方案，JSON - LD 在基于 RDF 的 API 中更常见 |
| 以模式为中心的 RDF 语言（如 OWL 和 RDF Schema） | |
| 模式文档（XML 消息用 XSD，JSON 消息用 JSON Schema） | 虽工具成熟，但通常仅用于定义词汇表的数据属性名称，不包含操作名称 |
| 应用级配置文件语义（ALPS）格式 | 可用于 XML、JSON 和 YAML 序列化 |

以下是一个用 FOAF 词汇表表达的人的 RDF 示例：

@prefix rdf: <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix rdfs: <http://www.