OpenAPI 规范中的强制性元素是什么
what are mandatory elements in OpenAPI spec
OpenAPI 规范的强制性元素是什么?
我的假设是 OpenAPI、Info 和 Path,对吗?
谢谢
OpenAPI 定义中的最少必填字段是:
- OAS 版本标识符,例如
openapi: 3.0.2
或swagger: 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.title
和 info.version
也可以是空字符串(例如 title: ''
),尽管这在实践中没有意义。
请仔细阅读下面的link,它解释了 Swagger 或 OPENAPI 规范所需的最少定义,希望您使用的 OPENAPI 规范是 .yaml
OpenAPI 规范的强制性元素是什么? 我的假设是 OpenAPI、Info 和 Path,对吗?
谢谢
OpenAPI 定义中的最少必填字段是:
- OAS 版本标识符,例如
openapi: 3.0.2
或swagger: 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.title
和 info.version
也可以是空字符串(例如 title: ''
),尽管这在实践中没有意义。
请仔细阅读下面的link,它解释了 Swagger 或 OPENAPI 规范所需的最少定义,希望您使用的 OPENAPI 规范是 .yaml