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文檔了。