痛點
如果你負責測驗的專案是一個前后端分離的專案,
回憶下是不是有如下場景:
某個專案開發完成,介面檔案發布在了 swagger 上,前后端各自進行開發,此時你負責這個專案的服務端測驗,
首先進行介面測驗,熟練的打開 postman 匯入 swagger 檔案,然后開始進行介面測驗,

介面測驗完成后,準備開始性能測驗,又要將 swagger 介面檔案將新介面遷移到 jmeter 上,然后開始撰寫壓測腳本,

某個專案在測驗中,由于后端修復 bug 改了介面引數,此時你進行介面回歸測驗,發現介面測驗腳本失敗,此時給開發提了一個 bug,

開發跑過來給你說,介面檔案有變動忘了個你說了,此時你只能默默的修改介面測驗用例,

服務上線一段時間后,某天,新員工開發小黃想想看下這個專案之前的介面檔案,發現測驗環境介面 swagger 地址打不開了,沒有地方可以看介面檔案,
其實上邊這些問題,在日常作業中很常見,其根本原因是介面檔案缺乏統一管理,有的團隊喜歡把介面檔案寫在內部協作檔案平臺里、有的團隊喜歡寫在 git 代碼倉庫里,它們的存放目錄及目錄深度各有不同,當后來人想要看介面的歷史檔案時,簡直無從查起,許多檔案就這樣遺失了,
你有沒有想過擁有一個,可以同時解決資料同步、除錯、Mock、自動化測驗的介面檔案管理工具,

什么是 eolink
結合 API 設計、檔案管理、自動化測驗、監控、研發管理和團隊協作的一站式 API 生產平臺,從個人開發者到跨國企業用戶,Eolink 幫助全球超過 30 萬開發者和數萬家企業更快、更好且更安全地開發和使用 API,
為什么選 eolink
支持 HTTP(S)、Websocket、TCP、UDP 等主流協議,通過代碼注解自動生成 API 檔案,或者從 API 檔案反向生成所有常見開發語言和框架的代碼,節省 API 設計和開發時間,強大的 API 版本和變更管理讓你不放過 API 的任何變動,
*支持所有主流協議
*** 代碼自動生成 API 檔案**
*** API 檔案自動生成代碼**
*** API 版本管理**
*** API 變更通知**
超方便的 API 測驗
支持多種方式快速發起 API 測驗,自動生成隨機測驗資料和測驗用例,一鍵對 API 進行批量回歸和冒煙測驗,并且立刻得到豐富詳細的測驗報告,讓繁瑣的 API 測驗變得如此簡單,
*** 支持在線、本地、客戶端進行測驗**
*** 一鍵進行回歸/冒煙測驗**
*** 快速創建測驗用例**
*** 自動生成測驗資料**
*** 豐富詳細的測驗報告**
0 代碼的 API 自動化測驗
不需要撰寫代碼,通過拖拉拽即可創建 API 測驗流程,API 檔案和測驗步驟自動關聯,當 API 檔案發生變化時自動同步到測驗用例,極低的學習和維護成本,并且通過定時自動測驗將測驗報告推送到郵箱、釘釘、企業微信、飛書、Jenkins 等平臺,與 CI/CD 流程無縫結合,
*** 與 API 檔案關聯與自動同步**
*** 0 代碼,拖拉拽完成測驗流程編排**
*** 統一管理測驗資料**
*** 對資料庫進行操作**
*** 定時自動測驗**
*** 測驗報告自動推送**
eolink 初體驗
我們看一下 eolink 是如何使用介面檔案管理工具、介面檔案生成工具這兩個功能,解決日常作業中,涉及介面檔案變更問題,
安裝注冊
eolink 是跨平臺的工具,支持 macOS(Intel+M1)、Linux、windows(32 位、64 位),在官網 https://www.eolink.com, 選擇對應系統的安裝包下載安裝即可用,

首次使用注冊賬號就可以使用,登錄 eolink 后,可以看到左側的專案、環境、高級功能,點擊專案,可以看到 API 檔案管理,

介面檔案管理
eolink 支持多種匯入資料方式,比如 swagger、jmeter、yapi、rap 等常用介面測驗工具,這里我們沿用使用 swagger 工具匯入資料,其他工具匯入的方式也大同小異,后續再介紹,

匯入介面資料后的介面串列展示效果,可以看到介面名稱、介面路徑、協議等引數,

隨便點擊一個介面,可以看到基本資訊、請求引數、回應內容,

點擊修改檔案/新建介面,可以編輯介面的資訊,點擊保存,可以觸發訊息通知給相關人員,

自動同步介面
在研發程序中,開發人員修改代碼,重啟服務后 swagger 工具會自動更新,但是 eolink 中還是舊的介面資料,這就會導致介面檔案不及時更新的問題,
在 eolink 可以通過代碼注解或者其他工具自動生成或抓取 API 檔案,是怎么做到的呢?
輸入專案的 swagger 地址,資料同步方式選擇增量更新,這樣做的好處是在舊介面檔案的基礎上增量修改,避免了重復新增介面資料,

在線介面檔案
根據定義好的介面,生成可以通過瀏覽器訪問的 web 地址分享給其他人,

在線介面檔案適合提供給本地沒有安裝 eolink 客戶端的用戶,方便大家隨時可以查看介面資訊、進行介面測驗,
另外在設定分享頁面,設定可見專案環境、設定分享的功能模塊,例如 Mock、API 測驗、API 測驗用例等等,
在線訪問地址

介面除錯
當我們設計好介面測驗用例之后,可以除錯看看效果,
以查詢商品介面為例,進入執行頁面,填寫完成引數值,選擇運行環境,點擊運行即可發起一個簡單的請求,頁面下方可查看介面回應、請求詳情,

介面除錯引數可以保存為一個介面測驗用例用例,方便下次除錯或者團隊成員測驗使用,
執行介面引數用例的目的是驗證不同測驗場景下介面的正確性,例如密碼錯誤、用戶名非法、引數值空等等,
如果需要從回應提取資訊以供后續請求使用,通過可視化 UI 操作即可 0 編碼實作提取變數和對回傳值斷言的操作,
入口在后置操作里面,我們從回應提取一 code 存為環境變數,并斷言回應里的 code 欄位值為"200",

可以查看** 內置函式手冊** , 使用內置函式進行斷言,如果介面回傳格式是 json 格式,可以使用 jsonpath 獲取需要的欄位值,進行斷言,
后置腳本例子,獲取 code 欄位引數:
var info = eo.http.response.get("info")
var code = eo.jsonpath("code",info);
eo.info(code);
if(code !=200){
eo.error("介面斷言失敗");
}
豐富的內置函式,基本上滿足日常測驗作業要求,包括: 單介面測驗、串聯介面測驗,

總結
隨著專案不斷的迭代,專案也越來越復雜,帶來的問題是,介面入參和出參會不斷地新增、修改,
測驗人員面臨的挑戰是:
1、如何獲取最新的介面檔案
2、如何降低介面測驗的成本
3、如何提高團隊協作的效率
eolink 既能管理介面又能做自動化測驗、好用好看還免費的介面檔案工具, 還不趕緊用起來~
圖中所使用的的介面管理工具是eolink,感興趣可以自行使用:www.eolink.com
轉載請註明出處,本文鏈接:https://www.uj5u.com/qita/465044.html
標籤:其他
