現在自己用php寫很多api接口,需要有個api管理系統專門來管理這些api,還請大家幫忙介紹個這樣的系統
回覆內容:
這個。 。 。 。 。不只是API的問題吧。 。 。核心(整體)系統在做架構設計的時候就要考慮進去,你現在半路來個只管暴露給外面的,這個框架沒多少意義,最多也就管管日誌,狀態等,新增接口,還是需要和數據提供的系統做很耦合的工作。
國外的話
Swagger(Swagger – The World's Most Popular Framework for APIs.),目前國內做得最好的是
EOAPI(EOAPI - 內內領先的介面管理平台目前國內做得最好的是EOAPI(EOAPI - 內內領先的介面管理平台。
EOAPI一直比較低調,相對於其他做噱頭的產品,它就更加專注於用戶體驗和功能性的提升,因此我也比較喜歡它。
EOAPI有線上版本和開源版本,基於PHP。
附上EOAPI的一些簡介(來自EOAPI的官網):
或介面管理apio
所有介面管理需求。
不再需要為每個專案搭建獨立的介面管理平台和編寫離線的介面文檔,一切的專案介面管理將在雲端進行。
傳統的word、excel以及自建wiki等文件工具,都無法擺脫編寫繁瑣、閱讀困難、維護麻煩等缺點。
eoapi能夠讓你註冊後便開始協作,其規範化的文檔、清晰的分類以及友好的閱讀介面,讓文件更新和協作不再痛苦。
傳統如DHC以及postman等測試工具已無法滿足介面管理工作,並且無法提供效能測試報告。 eoapi則將取代傳統測試工具,無須翻牆和安裝,只需網頁輕輕一點即可得知完整的介面測試資訊。
EOAPI個人開源版本(EOAPI - 業界領先的介面管理平台
):
-
ShowDoc是什麼 每當接手一個他人開發好的模組或項目,看著那些沒有寫註解的程式碼,我們都無比抓狂。文檔呢? !文檔呢? ! Show me the doc ! ! 程式設計師都很希望別人能寫技術文檔,而自己卻很不希望要寫文檔。因為寫文檔需要花大量的時間去處理格式排版,想著新建的word文檔放在哪個目錄等各種非技術細節。 word文檔零零散散地放在團隊不同人那裡,需要文檔的人基本上靠吼,吼一聲然後上qq或者郵箱接收對方丟過來的文檔。這種溝通方式當然可以,只是效率不高。
ShowDoc就是一個非常適合IT團隊的線上文件分享工具,它可以加快團隊之間溝通的效率。 -
它可以用來做什麼-
API文件( 查看Demo🎜🎜)🎜🎜🎜隨著行動互聯網的發展,BaaS(後端即服務)越來越流行。服務端提供API,APP端或網頁前端便可方便呼叫資料。用ShowDoc可以非常方便快速地寫出美觀的API文件。 🎜
- 資料字典( 查看Demo)
- 說明文檔
與它都有些什麼都用。匯出
響應式網頁設計,可將專案文件分享到電腦或行動裝置檢視。同時也可以將項目匯出成word文件,以便離線瀏覽。
-
公開項目與私人項目
-
- ShowDoc上的項目有公開項目和私人項目兩種。公開項目可供任何登入與非登入的使用者訪問,而私人項目則需要輸入密碼驗證訪問。密碼由項目創建者設定。
- 專案創作者可以自由地把專案轉讓給網站的其他使用者。
- 你可以很方便地為ShowDoc的專案新增、刪除專案成員。專案成員可以對專案進行編輯,但不可轉讓或刪除專案(只有專案創建者才有權限)
markdown編輯
- 編輯功能
markdown編輯 還是閱讀體驗都極佳很棒。如果你不了解Markdown,請在搜尋引擎搜尋"認識與入門Markdown"
-
模板插入 在ShowDoc的編輯頁面,點擊編輯器上方的介面按鈕可方便地插入API字典模板。插入模板後,剩下的就是改動數據了,省去了很多編輯的力氣。
-
歷史版本 ShowDoc為頁面提供歷史版本功能,你可以方便地把頁面恢復到之前的版本。
如果你沒有自己的伺服器,但又想使用ShowDoc作為分檔分享工具,你可以使用線上的ShowDoc ShowDoc
有,Kong - Open-Source API and Microservice Management Layer
阿里爸爸的RAP
github介紹:Table of Contents generated with DocTocRAP
?
RAP是一個GUI的WEB介面管理工具。在RAP中,您可定義介面的URL、請求&回應細節格式等等。透過分析這些數據,RAP提供MOCK服務、測試服務等自動化工具。 RAP同時提供大量企業級功能,幫助企業和團隊有效率的工作。
about_cn · thx/RAP Wiki · GitHub
什麼是RAP?
在前後端分離的開發模式下,我們通常需要定義一份介面文件來規範介面的具體資訊。如一個請求的位址、有幾個參數、參數名稱及型別意義等等。 RAP 首先方便團隊輸入、檢視和管理這些介面文檔,並透過分析結構化的文檔數據,重複利用並產生自測數據、提供自測控制台等等... 大幅提升開發效率。
about_cn · thx/RAP Wiki · GitHubRAP的特色
- 強大的GUI工具 給力的使用者體驗,你將會愛上使用RAP來管理您的API文件。
- 完善的MOCK服務 文件定義好的瞬間,所有介面已經準備就緒。有了MockJS,無論您的業務模型有多複雜,它都能很好的滿足。
- 龐大的用戶群 RAP在阿里巴巴有200多個大型專案在使用,也有許多著名的公司、開源人士在使用。 RAP跟隨這些業務的成行而成長,專注細節,掌握質量,經得住考驗。
- 免費 + 專業的技術支援 RAP是免費的,而且你的技術諮詢都將在24小時內得到答覆。大多數情況,在1小時內會得到答覆。
個人使用心得:
1、可以把json直接導入
2、可以在文件寫好的情況下,不要後台服務,直接使用MockJS產生測試資料
3、可以在寫字段名後ALT+Enter ,就把相同的字段的資料結構生成了。
4、可以把介面直接複製或移動到另一個地方
5、還要可以直接把文件導出,不過只能導出成html
WSO2 API Management
CrapApi:一個由anjularjs+bootstrap+springMVC搭建的免費開源的API接口、文檔管理系統(應用接口管理系統)CrapApi|接口管理系統
CrapApi|Api接口管理系統系統特點:簡單、極致、開源、前沿
主要功能:介面管理、介面偵錯、文件管理、資料字典管理....
演示位址:CrapApi|介面管理系統
GitHub開源位址:GitHub - EhsanTang/CrapApi: Programming Interface
碼雲端開源位址:CrapApi/CrapApi
Apizza - 為極客打造的api管理工具 http://apizza.cc
🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜🎜
🎜http://www.🎜🎜easyapi.com🎜🎜🎜🎜🎜 EasyAPI服務平台,包含API管理,API測試,API監控。我是創辦人。歡迎交流。
在原有api情況下再搞個API管理系統意義不大。其實工程師想要的是一整套API開發框架,所有API都是基於API框架開發,API框架整合基礎使用者係統,例如開源方案ucenter,API框架本身做到文件自動生成,整合測試助手,錯誤描述支援多國語言,get請求緩存,restful設計,和gitlab集成用於版本管理,接著Jenkins 上面自動化pull 版本單元測試,冒煙測試,壓力測試,運行日誌分析,提取失敗崩潰日誌併郵件通知。高階點 可以具體到 某個API 各種版本間的記憶體佔用曲線,相同並發量下請求時間曲線。持續整合扯遠了,生產API系統在運行時,可以做到精確到具體api級別的統計包括所有header信息,沒有正常返回結果API進行錯誤日誌記錄整理到日誌系統並email程式設計師郵箱,出入網規則則可以做到限制單位時間內各類請求等,例如限制特定的ip或ip段才可以進行某個API的patch請求,且一小時內5000次請求總量。 api支援多種類型請求如get post patch put delete head,支援多種資料類型回傳例如xml json jsonp msgpack壓縮的格式,提供多種程式語言的sdk,例如我的團隊做行動開發,我提供java objective- c版本的封裝類別庫,第三方團隊是搞golang的,封裝一個golang版本sdk,API系統支援即時生產pdf epub格式各個版本下的文件,sdk+sdk文件給客戶而不是把線上那套開放給客戶。以上除了持續整合那套,其他都屬於API系統工作,有空再曬圖。