OpenAPI 导入指南
OpenAPI 始于 Swagger 规范，是目前使用最广泛的 REST API 的 API 描述标准，由 Linux 基金会维护，官方最新版本为 OpenAPI 3.0。
需要注意的是 Swagger 规范已于 2015 年捐赠给 Linux 基金会后改名为 OpenAPI ：
- OpenAPI = 规范
- Swagger = 实现规范的一系列工具栈
获得 OpenAPI 描述文件
OpenAPI 描述文件可通过两种方式来编写：
- 人工编写 OpenAPI 的 YAML 或 JSON 文件，可使用 SwaggerHub 在线编写。
- 通过代码注解自动生成 OpenAPI 描述文件，如：SpringFox。
SwaggerHub
SwaggerHub 是 Swagger 的一个使用 OpenAPI 规范来设计和文档化的工具，它支持在线协作、托管 API 文档以及在线编辑，并且所见即所得。
上图所示为官方范例文档 PetStore，是一个比较完整的 OpenAPI 描述文件范例，如果需要对 OpenAPI 规范有个完整的认识，可参考《如何编写基于 OpenAPI 规范的 API 文档》
根据规范编写完成的 OpenAPI 描述文件即可用于导入 CODING API 文档管理中。
SpringFox
SpringFox 是一个自动将代码注解转换为 API 文档的工具，支持 Java 语言的 Spring 框架。您可通过参考 文档 实现自动化转换 API 文档。
下面我们通过 SpringFox 提供的 Demo 项目来生成 OpenAPI 描述文件。
打开命令行，下载 Demo 项目代码
> git clone https://github.com/springfox/springfox-demos.git进入代码目录
> cd springfox-demos编译代码
编译代码需要本地环境支持 Java 和 Gradle。
> ./gradlew idea或 Windows 用户
> gradlew.bat idea
命令行显示
BUILD SUCCESSFUL即为构建成功。启动本地服务器
> ./gradlew bootrun或 Windows 用户
> gradlew.bat bootrun
稍作等待，直到显示
FrameworkServlet 'dispatcherServlet': initialization completed in 14 ms即为启动成功打开浏览器，输入：
http://localhost:8080/swagger-ui.html
可看到 Swagger 文档，即为启动成功。
最后，下载 OpenAPI 描述文件
浏览器输入：
http://localhost:8080/v2/api-docs
右键选择「存储为」保存至本地，可命名为
xxx.json，该 OpenAPI 描述文件即可用于导入「CODING API 文档」中。
导入数据到「CODING API 文档」
在【发布新版本】页或者【录入 API 数据页】，选择【导入数据】下的【从文件导入】，导入刚才存到本地的 OpenAPI 描述文件，最后选择【完成并发布】实现文档发布。
2022-05-07最近更新在阅读中是否遇到以下问题？*
您希望我们如何改进？*
如果您希望得到回复，请留下您的邮箱地址。
