YApi

優(yōu)點

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

缺點

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

image.png

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

總結

該平臺的幫助：

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

目前來看存在的問題有如下幾個方面：

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

YApi使用

官方教程

添加項目

1. 創(chuàng)建入口

   
   
   image.png

2. 填寫項目信息

   
   
   image.png
   
   

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

   
   
   image.png

添加分類

image.png

添加接口

1. 添加接口入口

   
   
   image.png

2. 添加接口

   
   
   image.png

3. 添加成功

   
   
   image.png

4. 編輯

   
   
   image.png
   
   

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

   
   
   image.png
   
   返回參數(shù)：（1：手動輸入；2：導入json）
   
   image.png
   
   

   導入json后效果：

   
   
   image.png
   
   可對導入后的數(shù)據(jù)進行詳細填充
   
   image.png
   
   6.保存
   7.預覽
   
   image.png

MOCK

POST請求

mock地址

image.png

postman請求

image.png

GET請求

mock地址

image.png

postman請求

image.png