API的研发是一个周而复始的过程,随着技术的发达,开发周期逐渐缩短,往往在短时间内就可对API进行研发迭代,虽然这样做有利于快速完善产品,但版本变更迭代管理成为了一大麻烦。
为什么需要更改API
更改API是一件非常基本的事情,但更改API实际上是更改与用户之间的通信,关键还不能影响现有的环境,同时更改API也在所难免。更改API不仅仅会影响API的内容,如请求或响应的格式,也可以包括API的功能。无论API最初设计的多么出色,随着时间的流逝,必须对其进行更改。
管理API版本的好处
既然我们需要优化或频繁更改API,那么每进行一次更改就有必要生成一条记录,方便系统进行快速回滚的同时,有助于开发人员更好的理解每一个版本,并考虑如何让系统更好的发展。
每一次迭代都需要通知到相关的工作人员,例如测试或市场运营,测试人员需要对当前版本的API进行测试,而市场人员则需要对用户进行介绍最新的功能。
在API的生命周期中,API版本管理与API的安全性相关联。版本记录越详细,API的安全性也更加全面,并且还能够通过更全面的日志信息发现问题,进行测试与交付。
结语
是的,API版本管理确实很难,不仅要保证系统稳定,同时还要求及时将信息同步给所有关联的人员。为了后期方便对API版本进行管理,我们在设计API初期时就应该详细设计版本号,并考虑协助人员的合作与涉及人员的通知等各个方面。
演示工具为Eolinker,一个国产API整合管理工具。
使用地址:www.eolinker.com