swagger editor使用

swagger editor使用

swagger是一套开源的API设计工具，包括Swagger UI，Swagger Editor等。

Swagger Editor

其中Swagger Editor是个用Angular开发的WEB小程序，它能够让你用YAML来定义你的接口规范，并实时验证和现实成接口文档。

此外，它还能够经过接口文档帮你生成不一样框架的服务端和客户端，方便你mock和契约测试。最后导出JSON格式的API规范，经过Swagger UI对外发布。

生成PDF接口文档

如今书写和发布API文档变得快速和轻松，可是有时候，对端但愿能有一个离线的WORD或者PDF文档。但当前版本的Swagger Editor并无导出文档的功能。

转了转github，却是发现了几个开源项目，能够转换为PDF，可是感受都比较繁琐。

忽然想到浏览器能够打印成PDF格式，试验了一下，确实能够。不过接口不少内容都折叠起来了，看不到明细，起不到文档的做用。

不如写句JS，在控制台上运行一下，遍历下全部折叠的节点，而后单击打开。

var node = document.getElementsByClassName('toggle-handle');
for(var i= 0;i< node.length ; i++){  angular.element(node[i]).click();}

这下能够很方便的生成PDF文档了。