swagger ui生成api文件並進行測試

2022-06-14 21:48:14 字數 1710 閱讀 9674

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');

res.send('hello world!');

});

});

然後啟動,並執行檢視,如上**為3000埠,如有衝突請自行修改

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...