Swagger是遵守OpenAPI规范（OAS）的世界上最大的API框架开发工具，可在整个API生命周期内进行开发，从设计和文档到测试和部署。它提供了许多试用的工具来帮助开发者进行接口开发，如及时接口文档编写工具swagger-editor，前端展示swagger-ui，还有代码自动生成工具swagger-codegen。

下面会分别对这些工具进行介绍，由于Swagger的版本更新较快，功能愈发强大，所以我选择了使用swagger2进行整合，并且使用java语言进行示例。

swagger-codegen自动生成代码工具的介绍与使用 功能强大的swagger-editor的介绍与使用 swagger-ui生成api文档并进行测试

如果，你觉得swagger原生的ui风格不好看，想换换风格，你可以看这篇文章

Swagger 自定义UI界面