这是 OpenAPI 文档 的根对象。

4.8.1.1 固定字段

字段名称	类型	描述
openapi	字符串	必需 。此字符串必须是 OpenAPI 文档使用的 OpenAPI 规范的 版本号。openapi 字段应该被工具用来解释 OpenAPI 文档。这与 API info.version 字符串无关。**
info	信息对象	必需 。提供有关 API 的元数据。元数据可以根据需要由工具使用。
jsonSchemaDialect	字符串	此 OAS 文档中包含的 架构对象 中 $schema 关键字的默认值。这必须采用 URI 的形式。
webhooks	Map[string, 路径项对象	引用对象] ]
components	组件对象	用于保存文档中各种架构的元素。
security	[安全需求对象]	跨 API 可以使用哪些安全机制的声明。值的列表包括可以使用的替代安全需求对象。只需满足安全需求对象之一即可授权请求。各个操作可以覆盖此定义。若要使安全性可选，可以在数组中包含一个空的安全需求 ({})。
tags	[标签对象]	文档使用的一系列标签以及其他元数据。标签的顺序可以用于反映解析工具对其的顺序。并非 操作对象 使用的所有标签都必须声明。未声明的标签可以随机组织或基于工具的逻辑组织。列表中的每个标签名称必须唯一。**
externalDocs	外部文档对象	其他外部文档。
此对象可以使用 规范扩展 进行扩展。