1. 程式人生 > >詳解功能版本管理之使用eoLinker

詳解功能版本管理之使用eoLinker

object 可見 nts 平臺 sso fonts 一覽 多次 動態

先看一個對話:

“這裏,你改一下,這裏返回一個object。”

“好...好......”

“還有這裏,返回個String。”

......

在接口文檔改了7、8個version後,組長又發話了,“我覺得還是先前第2個版本的參數描述和說明更直觀一點,你改回來吧。”

......

“額......第二個版本的參數是怎麽寫來著......”

嗯,我一個180的大漢,這一刻想一拳打死組長。

已經不止一次遇到這樣的情況了,代碼不斷更新叠代,接口文檔同時根據代碼變動和進行細節上的改動,在改動多次後又倒退回原來的版本。雖說實踐出真知,但如果先前的文檔可以保存,根據討論來進行接口文檔版本切換...那就更好了...

現在公司終於拋棄了傳統的文檔編寫接口文檔的方式,采用在線接口管理平臺eoLinker錄入接口信息。eoLinker對api接口提供版本管理功能,清晰記錄了接口修改的動態,還可以進行一鍵化接口回滾。

例如可以通過設置接口狀態來區分接口,接口狀態分為啟用、維護和棄用

技術分享圖片

接口列表一覽

技術分享圖片

修改後點擊保存,填入更新描述,記錄接口修改描述。

技術分享圖片

選擇“歷史”,獲取最近十條接口修改歷史,接口歷史清晰可見。

技術分享圖片

選擇需要切換的接口歷史,便可一鍵切換

切換前

技術分享圖片

切換後

技術分享圖片

技術分享圖片

自從使用eoLinker進行接口版本管理,機械重復的工作就沒必要再做了,要切換回之前的接口版本,只需要點擊切換即可。

現在我已經沒有那種手刃組長的想法了,嗯,eoLinker讓組長多活幾年。

本文轉載於Blog.CSDN,已獲作者允許轉載。

詳解功能版本管理之使用eoLinker