[参考链接swagger3.0使用及踩坑](https://www.cnblogs.com/strongmore/p/18106597)

Swagger2 介绍

Swagger 是一个用于描述和记录 RESTful API 的项目。
Swagger 规范定义了描述此类 API 所需的一组文件。然后，Swagger-UI 项目可以使用这些文件来显示 API，并使用 Swagger-Codegen 来生成各种语言的客户端。其他实用程序也可以利用生成的文件，例如测试工具。