定义 openapi.json 文件

可以使用swagger官方的editor编辑工具视图化编辑，地址：http://editor.swagger.io/ ， 不但可以实时看到效果，还可以帮你检查语法错误。

目前openapi最新版本为3.0.2

我们定义的版本为3.0.0

其中定义的相关语法可以参考：https://github.com/OAI/OpenAPI-Specification/tree/master/versions

其他辅助工具

_Swagger _Editor

yaml 转json 工具

json 格式化工具

资料

Data Models (Schemas)

Swagger 2与OpenAPI 3

OpenAPI 3.0.0 通过SwaggerHub编写接口文档