符合 OpenAPI 规范的 OpenAPI 文档本身是一个 JSON 对象，可以以JSON 或YAML 格式表示。

例如，如果某个字段具有数组值，则将使用 JSON 数组表示形式

{
   "field": [ 1, 2, 3 ]
}

规范中的所有字段名称都区分大小写。这包括用作映射中键的所有字段，除非明确指出键不区分大小写。

架构公开两种类型的字段：固定字段，具有声明的名称；模式字段，为字段名称声明正则表达式模式。

模式字段必须在包含的对象中具有唯一的名称。

为了保留在 YAML 和 JSON 格式之间进行双向转换的能力，YAML 1.2 版本建议与一些其他约束一起使用

• 标签必须限于 JSON Schema 规则集 允许的标签。
• YAML 映射中使用的键必须限于标量字符串，如 YAML Failsafe 架构规则集 定义的那样。

注意： 虽然 API 可以通过 YAML 或 JSON 格式的 OpenAPI 文档来定义，但 API 请求和响应主体以及其他内容不需要是 JSON 或 YAML。