zoukankan      html  css  js  c++  java
  • API版本管理与变更通知

    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

  • 相关阅读:
    Git使用经验小结
    Git使用经验小结
    关于IT增值服务"拜师学艺"价格调整的通知
    关于IT增值服务"拜师学艺"价格调整的通知
    Java实现 LeetCode 397 整数替换
    Java实现 LeetCode 397 整数替换
    Java实现 LeetCode 397 整数替换
    Java实现 LeetCode 396 旋转函数
    Java实现 LeetCode 396 旋转函数
    Java实现 LeetCode 396 旋转函数
  • 原文地址:https://www.cnblogs.com/dc20181010/p/14081807.html
Copyright © 2011-2022 走看看