swagger(Web API 在线文档生成)

使用mvc+webapi，采取前后端分离的方式，后台提供API接口给前端开发人员。这个过程中遇到一个问题后台开发人员怎么提供接口说明文档给前端开发人员,之前一直使用的是word文档方式进行交流，效率低下而且不利于维护。书写api说明文档对于程序员来说想必是件很痛苦的事情吧，但文档又必须写，而且文档的格式如果没有具体要求的话，最终完成的文档则完全取决于开发者的心情。或者详细点，或者简单点。那么有没有一种快速有效的方法来构建api说明文档呢？答案是肯定的， Swagger就是最受欢迎的REST APIs文档生成工具之一！

 

参考资料：

https://www.cnblogs.com/liaods/p/10101513.html

http://www.imooc.com/article/272818

https://www.cnblogs.com/yilezhu/p/9241261.html

https://www.cnblogs.com/wskxy/p/10123714.html