OpenAPI 规范中的强制性元素是什么

what are mandatory elements in OpenAPI spec

OpenAPI 规范的强制性元素是什么? 我的假设是 OpenAPI、Info 和 Path,对吗?

谢谢

OpenAPI 定义中的最少必填字段是:

  • OAS 版本标识符,例如openapi: 3.0.2swagger: 2.0
  • info.title
  • info.version
  • paths – 可以为空,即 paths: {}

来源:OpenAPI Specification, section "OpenAPI Object"

样本最小定义:

openapi: 3.0.2
info:
  title: My API
  version: 1.0.0
paths: {}

技术上 info.titleinfo.version 也可以是空字符串(例如 title: ''),尽管这在实践中没有意义。

请仔细阅读下面的link,它解释了 Swagger 或 OPENAPI 规范所需的最少定义,希望您使用的 OPENAPI 规范是 .yaml

https://swagger.io/docs/specification/2-0/basic-structure/