swagger 安裝解說

通過讀取Swagger Edit的導出的YAML/JSON文件,來進行接口測試。下圖就是Swagger UI的界面:

這裏寫圖片描述

ps:Swgger UI的站點域名要和發送請求的域名一樣。不然瀏覽器會報跨域錯誤。
CORS跨域這裏附上解決跨域問題方法。

安裝

1.下載並且安裝node.js
2. npm install -g http-server
3. 下載項目https://github.com/swagger-api/swagger-ui 並且解壓。
4. 進入swagger-ui文件夾。運行http-server命令。
5. 進入http://127.0.0.1:8080/dist/index.html就可以看到swagger頁面了

使用

一.導入swagger.json文件

把之前Swagger Edit導出的swagger.json文件複製到dist文件夾裏面,修改index.html的url路徑,改成指向swagger.json。就可以讀取json文件的內容了。

二.測試接口

  1. 選擇接口點擊“try it out”。
    這裏寫圖片描述

  2. 修改“Example Value Model”裏面參數,點擊“Execute”發送請求。
    這裏寫圖片描述

  3. 點擊發送後會出現下面視圖,不管發送成功/失敗。你可以通過下面視圖來查看請求數據。
    這裏寫圖片描述

    字段 用途
    Curl 爲發送的請求參數信息。
    Request URL 就是發送的域名
    Code 請求的狀態碼。
    Response body 返回的參數。
    Response headers 服務器返回header頭。
發表評論
所有評論
還沒有人評論,想成為第一個評論的人麼? 請在上方評論欄輸入並且點擊發布.
相關文章