為了記錄項(xiàng)目每次更新迭代,往往會對項(xiàng)目進(jìn)行編號,每個編號代表一個項(xiàng)目版本。記錄項(xiàng)目版本可清楚的了解每次更新的詳細(xì)內(nèi)容,例如對某個功能進(jìn)行了某些更改,或新增了某些功能。
如今,項(xiàng)目已逐漸API化,對項(xiàng)目的更新迭代就是對API的更新迭代。項(xiàng)目API化的好處之一是API方便記錄為文檔形式,從一開始使用office,到現(xiàn)在越來越多方便的API文檔工具,API管理工具使API文檔化的過程不斷優(yōu)化,讓API更加方便管理。
API文檔管理復(fù)雜且實(shí)時性不高,為此API管理工具提供了在線API文檔解決方案。解決了API文檔難記錄的問題同時,還可以對API進(jìn)行版本管理。
以Eolinker為例,在Eolinker系統(tǒng)中,項(xiàng)目可以創(chuàng)建多個API版本??筛鶕?jù)項(xiàng)目需求進(jìn)行定義,如:V1.0,V1.0.1等。
Eolinker在修改API后可自動生成一條數(shù)據(jù),新建的版本可以在API文檔界面進(jìn)行設(shè)置,或批量設(shè)置多個API版本,設(shè)置后在版本界面可查看版本的API 統(tǒng)計信息。
Eolinker還支持對版本進(jìn)行對比,對比兩個項(xiàng)目內(nèi)的API或?qū)Ρ炔榭磫蝹€API的兩個版本。
API管理工具不僅僅只用于管理API文檔,工具開發(fā)者深入了解了API的應(yīng)用場景,為API的管理帶來了方便且快捷的功能,讓整個項(xiàng)目團(tuán)隊都可以從API管理工具中受益。
工具地址:www.eolinker.com