一.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頁面了。