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