今天栈长给大家推荐一款接口API设计神器。传说中的，牛逼的Swagger，到底是什么？今天就为大家揭开谜底！什么是招摇？官网：https://swagger.io/Swagger如官网所示，是最好的API构建工具。它是一个围绕OpenAPI规范构建的开源工具，可帮助我们设计、构建、记录和使用RESTAPI接口。Swagger中包含的主要套件：SwaggerEditor-用于编写OpenAPI规范的基于浏览器的编辑器。SwaggerUI-根据OpenAPI规范动态生成API规范文档。SwaggerCodegen-用于生成客户端代码的模板驱动引擎。图片来源见博客水印。什么是OpenAPI？上面提到Swagger是一个围绕OpenAPI规范构建的开源工具，那么什么是OpenAPI呢？OpenAPI规范，以前称为Swagger规范。它是RESTAPI接口定义的规范。OpenAPI可以定义的API实体内容包括以下几个部分。请求地址（如：/user）请求类型（如：GET、POST等）请求参数响应参数校验方式文档信息：如联系人、许可、服务条件等。这个OpenAPI规范可以用YAML来写或JSON。该格式非常容易学习，可读性也非常适合开发人员。完整的OpenAPI规范可以在官方网站上找到。https://github.com/OAI/OpenAPI-Specification编写文档地址：http://editor.swagger.io/为什么需要Swagger？现在的互联网架构是前后端分离的模式，现在是移动互联网时代。APP需要和后台服务器通信，维护一套接口。API文档自然成为了前后端开发者之间的纽带。API文档也有不同的写法，比如WORD和confluence等，但是这些方法不能动态更新。每次界面变化，都需要手动维护文档，非常麻烦。使用Swagger可以先完成接口，通过Swagger动态生成和更新API文档。后续文章会继续介绍如何使用Swagger注解自动生成API文档，以及如何结合SpringBoot应用实战。
