眾多介面管理工具如雨後春筍搬冒出。讓人欣慰的是,有許多優秀作品來自國內,包含yapi和rap。
看著中文的官網,熟悉的漢語,不禁讓人暗爽。當然這也就帶來另乙個弊端,因為使用基數少,所以參考資料少。我們想學習使用方法,只能依賴官方文件,也算是福禍相倚了。
本文將帶您走進yapi的世界,讓您體驗一回小清新的介面管理工具。
根據統計,市面上網際網路專案超過10億,保守統計涉及的api數量有100億。但是很多api的質量堪憂。因為與api相關的文件、除錯、測試和資料mock在工作中效率非常低。
我們急需一款產品,它需要具有介面管理功能,提供除錯,文件管理和測試功能。這時yapi橫空出世。
這是乙個介面管理平台,可以幫助開發者建立、發布和維護api。yapi 還為使用者提供了優秀的互動體驗。開發人員只需利用平台提供的介面資料寫入工具以及簡單的點選操作就可以實現介面的管理。
1080×364 35.3 kb
yapi適合公司業務比較複雜,尤其是跨部門協作的情況下使用,和它類似的工具還有rap、swagger、moco。
rap也具有圖形介面,但火爆程度逐漸不如yapi。而swagger呢,是乙個超級強大的工具,它的野心已經不滿足於介面管理,後續課程會講到它。
moco在13年獲取duke選擇獎,moco的使用也很簡單,維護乙份json檔案,然後利用命令執行。
在這麼多工具面前,yapi能夠脫穎而出實屬不易。在實際工作中,yapi和swagger屬於兩個流派,前者易於管理,有著友好的ui介面,但生態弱,依賴人工和ui維護。而swagger呢,是乙個十足的野心家,已經提供api全生命週期的解決方案,它已經不是工具,已然成為了標準。
進入yapi後,這頁面,這ui,確實小清新,不愧是後起之秀。這裡簡單進行介紹,它主要有下面四個部分:
1.首頁頭部展示了當前所在的位置、搜尋框、新建專案、檢視文件和使用者資訊。
2.首頁左側展示分組資訊,「分組」是「專案」的集合,只有超級管理員可以管理分組。
3.首頁右側是分組下的專案和成員列表,點選左側的某個分組,右側會出現該分組下的專案和成員資訊。
4.點選專案右上角的星星即可關注專案,關注的專案可以在「我的關注」頁面檢視。
1080×581 56.8 kb
其實不光是首頁ui,他的專案ui也令人咋舌,在ui上這麼清新的國內平台已經非常少見。
點選乙個專案,進入專案頁,專案頁展示了屬於該項目的全部介面。並提供專案、介面的全部操作。
5.專案頁左側的 「介面列表」 展示了該專案下的所有介面,右側預設顯示該專案下所有介面的列表。
6.點選左側的某個介面,右側會出現「預覽」、「編輯」和「執行」。
7.點選左側的 「測試集合」 使用測試集功能。
8.點選二級導航的「設定」,專案組長即可編輯專案資訊和管理成員列表。
9.點選二級導航的「動態」,即可檢視專案的操作日誌。
有的讀者已經迫不及待了!下面用乙個簡單例子來入門yapi,在專案裡新建介面,這時會彈出乙個視窗,幾個選項都很清楚,介面路徑是什麼?這是方便前端呼叫後端,而設定的介面路徑:
1080×472 49.4 kb
期望mock可以根據設定的請求過濾規則,返回期望資料,這是乙個高階玩家。要想使用它,你要先進入介面詳情頁,然後點選高階mock。
1080×286 34.1 kb
1080×872 34.9 kb
845×659 23.1 kb
950×647 65.4 kb
RAP介面管理工具
rap是阿里開源的介面管理工具,主要包括開發團隊 專案的管理,編寫api介面,mock服務,介面測試,生成介面文件等功能。並且rap是可以在本地環境中進行部署使用的 linux,windows皆可 這裡也建議本地部署,第一不受網路限制,第二資料放在自己的資料庫中便於後續的功能擴充套件或分析。一 建立...
rap介面管理工具
在前後端分離的web開發模式中,通常需定義介面文件來規範其介面形式,如介面位址 引數 型別 含義等。rap 致力於提供方便的視覺化工具錄入並維護這些文件,並通過分析這些文件資料,重複利用,生成自測資料 校驗真實資料,提公升開發效率。介面管理工作由來已久,傳統管理方式無論用word wiki或更高階的...
Redis Web介面管理工具
乙個很友好的redis web介面管理工具。基於.net實現。可以通過mono部署到linux上,下面是我部署在centos 5.7 mono 2.10.8 jexus 5.0.1 詳情介紹 redis的客戶端redis cli不是太好用,退格鍵和箭頭都不能正常使用,這個的確影響效率,redisco...