最近公司在開發一款app,之前一直使用swagger做為介面的文件線上自動生成+功能測試,由於swagger是國外的一款管理工具,訪問和使用起來不是很方便,所以團隊決定尋找一款國內的介面管理以及介面測試工具,於是詢問了下隔壁專案組現在使用的是哪款管理工具,隔壁專案組給我們推薦了DOClever,於是下載部署試用了一下,感覺就一個字 強!
一、先介紹下Swagger
Swagger™的目標是為REST APIs
定義一個標準的,與語言無關的介面,使人和計算機在看不到原始碼或者看不到文件或者不能通過網路流量檢測的情況下能發現和理解各種服務的功能。當服務通過Swagger定義,消費者就能與遠端的服務互動通過少量的實現邏輯。類似於低階程式設計介面,Swagger去掉了呼叫服務時的很多猜測。
瀏覽 Swagger-Spec 去了解更多關於Swagger 專案的資訊,包括附加的支援其他語言的庫。
Swagger官網地址:swagger.io/
二、再來介紹下DOClever
DOClever是一款開源免費的視覺化介面管理工具,專業的api介面管理系統,集介面文件、介面自動化測試、Mock資料、團隊協作、介面快照等於一身的移動時代首選介面管理平臺!(官網介紹)
DOClever官網:www.doclever.cn
三,從Swagger匯出Json到DOClever
1、從Swagger匯出一份JSON檔案,或複製Swagger上的專案地址
2、把匯出的JSON檔案匯入到DOClever,如下圖:
點選匯入專案
這裡支援兩種匯入方式
1、URL匯入
2、JSON匯入
無論我們選擇那一中方式,當匯入之後點選儲存;這時我們會看到我們在Swagger上的專案已經匯入到DOClever;
DOClever提供的專案匯入可以很方便的幫助我們把在Swagger、rap、postman上面的已有專案快速遷移到DOClever上面;