自从我用了这个接口文档版本管理,我的组长多活了几年

“这里,你改一下,这里返回一个object。”

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

“还有这里,返回个String。”

......

在接口文档改了7、8个version后,组长又发话了,“我觉得还是先前第2个版本的参数描述和说明更直观一点,你改回来吧。”

......

“额......第二个版本的参数是怎么写来着......”

嗯,我一个180的大汉,这一刻想一拳打死组长。

 

已经不止一次遇到这样的情况了,代码不断更新迭代,接口文档同时根据代码变动和进行细节上的改动,在改动多次后又倒退回原来的版本。虽说实践出真知,但如果先前的文档可以保存,根据讨论来进行接口文档版本切换...那就更好了...

 

现在公司终于抛弃了传统的文档编写接口文档的方式,采用在线接口管理平台eoLinker录入接口信息。eoLinker对api接口提供版本管理功能,清晰记录了接口修改的动态,还可以进行一键化接口回滚。

 

例如可以通过设置接口状态来区分接口,接口状态分为启用、维护和弃用



接口列表一览



修改后点击保存,填入更新描述,记录接口修改描述。



选择“历史”,获取最近十条接口修改历史,接口历史清晰可见。



选择需要切换的接口历史,便可一键切换

切换前


切换后


 

自从使用eoLinker进行接口版本管理,机械重复的工作就没必要再做了,要切换回之前的接口版本,只需要点击切换即可。

现在我已经没有那种手刃组长的想法了,嗯,eoLinker让组长多活几年。


  • 3
    点赞
  • 5
    收藏
    觉得还不错? 一键收藏
  • 4
    评论
评论 4
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值