前后端都分離了，該搞個好用的API管理系統(tǒng)了

Bladexu的文庫 2019-12-26

展開全文

為啥需要API管理系統(tǒng),！

互聯(lián)網(wǎng)服務發(fā)展至今,，作為開發(fā)者陣營的我們，已經(jīng)用實踐證明了前后端分離開發(fā)模式正在逐漸成為越來越多互聯(lián)網(wǎng)公司構建服務和應用的方式,。

前后端分離優(yōu)勢多多,，其中一個很重要的優(yōu)勢是：對于后臺服務（系統(tǒng)）來講，只需提供一套統(tǒng)一的API接口,，可被多個客戶端所復用,，分工和協(xié)作被細化，大大提高了效率,。

與此同時帶來的一些副作用便是：

接口文檔管理混亂,。之前很多公司管理API接口，有用Wiki的,，有Word文檔的,，有Html的，經(jīng)常遇到問題是接口因變了,，比如增加參數(shù),，參數(shù)名變了，參數(shù)被刪除了等都沒有及時更新文檔的情況
接口測試沒有保障,。畢竟前端開發(fā)依賴后端接口,，如果前后端開發(fā)不同步，接口及時測試成了問題,，因此需要隨時提供一套可用的API接口數(shù)據(jù)測試服務。
資源分散,，難以共享,。每個開發(fā)者維護自己的一套測試接口集合，無法共用他人接口集合,，開發(fā)過程中充斥著大量重復造數(shù)據(jù),、填接口的工作，效率不高
其他問題,。除此之外還有可能碰到諸如文檔導出,、接口分類規(guī)劃、操作便利性等一系列問題,。

基于此情況,，因此本文接下來就來推薦幾個常用的 API管理系統(tǒng)，幫助前后端分離開發(fā)模式下提升效率和可靠性，總有一個你看得上,！

Swagger

Swagger 是一個規(guī)范和完整的框架,，用于生成、描述,、調(diào)用和可視化 RESTful 風格的 Web 服務,。它可以方便地和 Spring MVC、Spring Boot等框架進行快速整合,，并且通過結合諸如Swagger-UI等組件,，將 controller層的方法進行方便地可視化展示，像方法注釋,，方法參數(shù),，方法返回值等都提供了相應的用戶界面。

前后端都分離了,，該搞個好用的API管理系統(tǒng)了

項目主頁： https:///

YApi

YApi 是高效,、易用、功能強大的 api 管理平臺,，旨在為開發(fā),、產(chǎn)品、測試人員提供更優(yōu)雅的接口管理服務,。它可以幫助開發(fā)者輕松創(chuàng)建,、發(fā)布、以及維護API,。除此之外,，YApi 還為用戶提供了優(yōu)秀的交互體驗，開發(fā)人員只需利用平臺提供的接口數(shù)據(jù)寫入工具以及簡單的點擊操作就可以實現(xiàn)接口的管理,。

前后端都分離了,，該搞個好用的API管理系統(tǒng)了

功能特性：

基于 Json5 和 Mockjs 定義接口返回數(shù)據(jù)的結構和文檔，效率提升多倍
扁平化權限設計,，即保證了大型企業(yè)級項目的管理,，又保證了易用性
類似 postman 的接口調(diào)試
自動化測試, 支持對 Response 斷言
MockServer 除支持普通的隨機 mock 外，還增加了 Mock 期望功能,，根據(jù)設置的請求過濾規(guī)則,，返回期望數(shù)據(jù)
支持 postman, har, swagger 數(shù)據(jù)導入
免費開源，內(nèi)網(wǎng)部署,，信息再也不怕泄露了

項目主頁： http://yapi.demo.qunar.com/

eolinker

eolinker也挺好用,，UI好看，是一個開箱即用的API研發(fā)管理方案,，0代碼實現(xiàn)API自動化測試,。

前后端都分離了,，該搞個好用的API管理系統(tǒng)了

功能特性：

開箱即用的API研發(fā)管理方案：無需繁瑣的配置，支持讀取代碼注解生成API文檔,，或者是通過UI界面快速創(chuàng)建全面的API文檔,。通過Mock API、API變更通知,、版本管理等服務,，讓團隊更敏捷。
強大的“0代碼”API測試 / 自動化測試：全面支持HTTPS,、Restful,、Web Service等類型API。強大的API自動化測試和用例管理功能,，讓你不寫代碼實現(xiàn)API自動化測試,，實時生成測試報告，提高測試覆蓋率,。
實用的團隊協(xié)作功能：提供強大的人員權限管理功能,，你可以為不同的成員設置允許執(zhí)行的操作，系統(tǒng)會自動記錄成員的所有操作日志,。并且可以通過豐富的插件系統(tǒng)來擴展現(xiàn)有的系統(tǒng)功能,。
開放的平臺設計：一鍵導入Postman、Swagger等產(chǎn)品數(shù)據(jù),，讓您快速享受到EOLINKER API Studio的服務,。您還可以通過Open API將EOLINKER API Studio對接到各類企業(yè)內(nèi)部系統(tǒng)中，實現(xiàn)開發(fā),、測試,、運維一體化。
支持離線的私有化部署：EOLINKER API Studio支持離線的私有化部署,，產(chǎn)品以及數(shù)據(jù)均儲存在企業(yè)內(nèi)部,，您可以根據(jù)部門/分公司設立相互隔離的工作空間，并且通過Open API對接Jenkins等各類持續(xù)集成系統(tǒng),。

項目主頁： https://www./

ShowDoc

ShowDoc 是一個非常適合IT團隊的在線文檔分享工具,，它可以加快團隊之間溝通的效率。免費開源,！

支持如下特性：

API文檔： 隨著移動互聯(lián)網(wǎng)的發(fā)展，BaaS（后端即服務）越來越流行,。服務端提供API,，APP端或者網(wǎng)頁前端便可方便調(diào)用數(shù)據(jù)。用 ShowDoc可以非常方便快速地編寫出美觀的API文檔,。
數(shù)據(jù)字典： 一份好的數(shù)據(jù)字典可以很方便地向別人說明你的數(shù)據(jù)庫結構,，如各個字段的釋義等,。
說明文檔： 你完全可以使用showdoc來編寫一些工具的說明書,也可以編寫一些技術規(guī)范說明文檔以供團隊查閱

前后端都分離了，該搞個好用的API管理系統(tǒng)了