一.swagger簡介　

　　swagger是一套開源的API設計工具，包括Swagger UI和Swagger Editor等。其中swagger edit是用來編輯介面文件的小程式，非常簡單易用。在官網上分為線上編輯和下載程式碼線下編輯的兩種編輯方式。

　　swagger是通過YAML來定義你的介面規範，可以通過yaml格式（標準json可以自動轉換成yaml格式）的介面文件幫你生成不同語言的服務端和客戶端程式碼。

二.swagger安裝

　　1.下載安裝node.js

　　　　下載地址：https://nodejs.org/en/download/

　　　　驗證是否安裝成功

　　2.執行命令

npm install -g http-server

　　此時如果報錯誤資訊如下：

　　命令改為

sudo npm install -g http-server

　　3.下載專案https://github.com/swagger-api/swagger-editor 並且解壓

　　4. 進入swagger-editor資料夾。執行http-server命令。 
　　5. 進入http://127.0.0.1 就可以看到swagger頁面了。