前言
本章知识重点：API文档诞生的背景、swagger2 的作用、swagger2 与SpringBoot如何集成、以及实践的案例，通过案例一目了然的掌握API文档的应用，帮助开发人员解决API维护困难的烦劳。
目前主流的开发模式都是前后台分离模式，后台开发人员提供API接口，前端开发人员调用API接口，测试人员先进行API接口单元集成测试，这就是目前开发过程的主流模式。前端调用API的接口的时候，需要一个API接口开发指南的文档，按传统的做法就是维护API文档，维护API文档有一个重大的问题，就是API接口可能存在经常变更的情况，维护API文档很困难，为了解决此问题，需要将API接口文档维护工作交给开发人员自己维护。 为了解决此问题，我们期望API开发过程中，有一个框架能自动编译生成API接口文档，及时公开给前端开发人员。而swagger2就承担了这样的使命，能很好的解决此问题，提高研发协调效率。
Swagger2是一个规范和完整的框架，用于生成、描述、调用和可视化RESTful风格的Web服务。它可以帮助开发人员自动生成API文档、客户端和服务端的代码，以及在线接口调试页面等。使用Swagger2可以节省维护成本，提高开发效率，同时可以做到调用端代码、服务端代码以及接口文档的一致性。Swagger2的出现是为了解决API接口众多、细节复杂、难以维护等问题。