官网 https://swagger.io/

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

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

功能强大的swagger-editor的介绍与使用  --生成API文档，兼生成服务端代码

swagger-ui生成api文档并进行测试   --API文档和接口测试

如果，你只是想在你的java spring工程里使用swagger，那么你可以直接看这篇文章

Spring Boot中使用Swagger2构建强大的RESTful API文档

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

Swagger 自定义UI界面

标准

OAS标准（OpenAPI规范标准） https://www.jianshu.com/p/5365ef83252a

Swagger接口测试框架-知识集锦

原文：https://www.cnblogs.com/jiftle/p/12272442.html