swagger ui是乙個
apigithub
github:
zip
檔案)
git clone .git解壓好的檔案
主要用到的是dist目錄,可以進入
dist
目錄開啟
index.html
看下介面,可以發現基本的模式是有了,但都是靜態的檔案。下面我們要進行nodejs配置,使其可以進行埠訪問,直接使用
node
命令訪問
index.js
沒有反應,英語稍微好點的同學可以看下官網的配置步驟,接下來手動配置
ui環境。
npm init根據提示輸入好資訊後會自動建立package.json檔案,如下圖:
初始化命令npm init,出現如下資訊,填的地方可以隨便寫,也可以不寫。
dist
資料夾拷貝到
下。
install express
建立index.js,並將如下**寫入該js中
var express = require('express');然後啟動,並執行檢視,如上**為3000埠,如有衝突請自行修改res.send('hello world!');
});
});
node index.js訪問
你可能會疑惑:這個uber api怎麼來的呢?下面我再給您解釋下這個
uber api
的來路,編輯
index.html
檔案你會發現有一段url引用了
swagger
官網的jsonapi
檔案
index.html
平級
然後存放到如下目錄,並修改index.html
把index.html裡的url換成
swagger.json
(注意這回寫的是相對路徑啦)
tomcat
的目錄下,然後啟動
tomcat
8070
是我的tomcat
的埠,因為我的
8080
埠已經執行了
可以看到和在express裡訪問的一樣。
swagger ui生成api文件並進行測試
swagger ui是乙個 apigithub github zip 檔案 git clone git解壓好的檔案 主要用到的是dist目錄,可以進入 dist 目錄開啟 index.html 看下介面,可以發現基本的模式是有了,但都是靜態的檔案。下面我們要進行nodejs配置,使其可以進行埠訪問,...
swagger ui教程 構建api介面文件工具
demo參見 自動的在 中分析rest介面,生成rest介面描述json。這個json又可以被客戶端生成文件,以及測試用的web頁。例如 有改造的swagger ui的中文版了。或者 data.json 可以參考 個人使用說明 2 找到swagger ui master dist index 檔案,...
go實踐之swagger自動生成api文件
作為乙個後端開發,給前端提供api介面是必須的。手動去寫文件不是乙個程式設計師的風格。swagger就是乙個很好的api文件生成該工具,go當然也支援了。下面看看怎麼使用這個工具。安裝gin swagger,用來整合到我們前一篇文章go實踐之apiserver搭建實現的apiserver當中去。在r...