API文档工具swagger-简单说

现在的网站架构基本都由原来的后端渲染，变成了：前端渲染、先后端分离的形态，

前端和后端的唯一联系，变成了API接口；API文档变成了前后端开发人员联系的纽带，变得越来越重要，swagger就是一款让你更好的书写API文档的框架。

API文档工具前世今生

没有API文档工具之前，大家都是手写API文档的，在什么地方书写的都有，有在confluence（wike）上写的，有在对应的项目目录下readme.md上写的，

高端点的还有用阿里的RAP  

 github地址为：https://github.com/thx/RAP   

部署文档https://github.com/thx/RAP/wiki/deploy_manual_cn

swagger

rap挺好的，但是和swagger比起来有点轻量。 

下面再细看看swagger的生态的具体内容：

swagger-ui

swagger-editor

就是一个在线编辑文档说明文件（swagger.json或swagger.yaml文件）的工具，以方便生态中的其他小工具（swagger-ui）等使用。 
左边编辑，右边立马就显示出编辑内容来。 

编辑swagger说明文件使用的是yaml语法

swagger-codegen

代码生成器，脚手架。可以根据swagger.json或者swagger.yml文件生成指定的计算机语言指定框架的代码。