如何用 Swagger 消除前后端分离的障碍

随着后端技术的日渐成熟和前端框架的异军突起，前后端分离几乎已经企业开发必须要选择的方向。但是采用了 JSP、Struts2、SpringMVC 等技术的项目在实现前后端分离时，由于 Web 容器的使用，使得前端开发人员无法专注于前台展示，分离起来困难重重。

RESTful 架构的引入，让电脑端、移动端、第三方系统的数据交互和流程控制更加便捷，也使得前后端分离成为可能。但是随着项目的推进，众多的 API 如果管理不当，在项目集成时，又将陷入泥潭。而 Swagger 的出现专注于为 API 提供可视化文档，便于前后端开发人员对接。

本场 Chat 将向读者展示 Swagger 的如下方面：

为什么要用到 Swagger

如何最简便的用到 Swagger

基于 YAML 语法的 Swagger 实例

一些 Swagger 最佳实践

在 Spring-boot 中使用 Swagger

实录提要：

非技术人员如何能说服开发使用 swagger？

swagger 和 deloyd 有什么区别？什么情况下应该使用？

针对 PHP 有没有工具把 phpdoc 格式的注释转化为 swg 格式？

前后分离时，前端需要明确所有的输入输出参数，这个怎么配置更方便？

swagger-ui、swagger-editor、swagger-api、swagger-node 能不能梳理一下?

从 docker hub 上 pull swaggerapi/swagger-ui 之后，如何定制自己的模拟接口？

前后端分离，假设前端部署在 node 上，后端用 springboot 如何处理认证登录？

阅读全文: http://gitbook.cn/gitchat/activity/59b7309475fc6561ad7ba27e