YApi

優(yōu)點(diǎn)

顏值高；安裝簡(jiǎn)便；集成WIKI、接口編寫(xiě)、接口自動(dòng)化測(cè)試于一體，更新非常及時(shí)；支持權(quán)限管理；支持swagger等其他API管理工具的格式數(shù)據(jù)導(dǎo)入；支持LDAP、SSO、CAS等登錄方式；支持集群。

缺點(diǎn)

（1）接口返回值只能設(shè)置一個(gè)模板
有時(shí)候我們希望正確返回設(shè)置一個(gè)模板、錯(cuò)誤返回設(shè)置一個(gè)模板，這是swagger可以做到的，而YAPI無(wú)法做到
（2）接口模板必須復(fù)制粘貼
不像swagger解耦合一樣，一處配置處處運(yùn)行，例如配置“分頁(yè)模板”，然后每個(gè)分頁(yè)只需要引用一下就好了，修改起來(lái)只需要修改一次。而YAPI目前只有復(fù)制粘貼。
已經(jīng)有人提issue了：

image.png

3）測(cè)試功能太雞肋
只能做冒煙測(cè)試，給數(shù)據(jù)、返回期望數(shù)據(jù)。無(wú)法編寫(xiě)測(cè)試邏輯（如果返回XX則跳到XX），無(wú)法返回多個(gè)值（如果200則XX，如果404則XX），也就無(wú)法編寫(xiě)單元測(cè)試了。
簡(jiǎn)單總結(jié)會(huì)議：yapi接口管理平臺(tái)，在開(kāi)發(fā)偏敏捷的情況下，對(duì)接口的規(guī)范性，前后端聯(lián)調(diào)便捷性，冒煙測(cè)試、線上回歸，起到了積極作用，但對(duì)于測(cè)試來(lái)說(shuō)，測(cè)試功能比較雞肋。

總結(jié)

該平臺(tái)的幫助：

    1，mockserver方案：解決前期模擬測(cè)試數(shù)據(jù)，便于調(diào)試；
    2，服務(wù)端接口開(kāi)發(fā)：規(guī)范后臺(tái)api文檔，豐富了開(kāi)發(fā)自測(cè)方案，間接提高開(kāi)發(fā)質(zhì)量；
    3，前后端聯(lián)調(diào)：減少聯(lián)調(diào)溝通成本；
    4，測(cè)試方面：更好的進(jìn)行接口測(cè)試，接口冒煙測(cè)試，以及線上驗(yàn)收測(cè)試；

目前來(lái)看存在的問(wèn)題有如下幾個(gè)方面：

   1，文檔管理方面：接口歷史文檔查看和管理，無(wú)法操作；
   2，接口關(guān)聯(lián)性方面：接口返回?cái)?shù)據(jù)的獲取和下一個(gè)接口使用，不易用；
   3，變量管理+前置腳本調(diào)試方面：前置腳本sign或其他參數(shù)獲取，做為公共變量或私有變量傳遞，不易用；
   4，版本管理：目前tag更多的是標(biāo)簽作用；
   5，自動(dòng)化方面：異常用例管理和編寫(xiě)，局限性過(guò)大，不易進(jìn)行；
   6，協(xié)議局限性：websocket等類(lèi)似協(xié)議接口無(wú)法測(cè)試；

YApi使用

官方教程

添加項(xiàng)目

創(chuàng)建入口

image.png
填寫(xiě)項(xiàng)目信息

image.png

3.創(chuàng)建后效果

image.png

添加分類(lèi)

image.png

添加接口

添加接口入口

image.png
添加接口

image.png
添加成功

image.png
編輯

image.png

5.請(qǐng)求參數(shù)及返回參數(shù)
請(qǐng)求參數(shù)：

image.png

返回參數(shù)：（1：手動(dòng)輸入；2：導(dǎo)入json）

image.png

導(dǎo)入json后效果：

image.png

可對(duì)導(dǎo)入后的數(shù)據(jù)進(jìn)行詳細(xì)填充

image.png

6.保存
7.預(yù)覽

image.png