API版本化与迁移五大策略

日期:2016-3-22作者:Fred Churchville翻译:崔婧雯来源:TechTarget中国 英文

API   API版本化   迁移策略   

【TechTarget中国原创】

业务需求在改变,这通常意味着API必须随之而改变。本文探讨当API必须改变时避免悲剧的五大关键策略。

API版本化和迁移是不得不解决的问题,特别是在应用程序接口和不断变化的业务优先级绑定越来越紧密的当下。但是,如果采取一些关键步骤,改动API就不会造成悲剧。

我们采访了Inversoft的CEO,Brian Ponterelli,他分享了五个他所使用的最重要的策略,能够减少API改动的风险。

1.文档化时间线

当API开发完成时,很可能已经计划的一些patch或者功能版本可能会破坏兼容性。要想避免你的API客户因此而愤怒,Ponterelli建议开发人员共享一份“事件日历”,记录下可能会影响到用户的任何变化。

“我们将这样的文档和发布摘要和文档放在一起,受到了用户的好评。”Ponterelli说。“有很多种方法,但是只要某个地方有“文档”,你就可以安心。”

2.拥抱语义版本控制

语义版本控制是业界针对patch版本的事实命名惯例,并且根据Ponterelli所说,使用它对于确保API版本控制不出乱子至关重要。这种正式的标准,已经被很多大公司采用 -- Oracle,Google -- 为版本号以及哪些兼容性会被破坏或者不受影响等,提供了清晰的说明书。

对于理解语义版本控制的API客户而言,Ponterelli说,很多客户确实理解,持续跟踪改动会很容易。对于不熟悉该领域的客户,也很容易找到介绍其如何工作的文档。

3.制定迁移策略以及向后兼容适配器

当新版本即将发布时,通常迫使开发人员打破某种兼容性。不幸的是,你的API使用者可能严重依赖于这些特定的兼容性,Ponterelli提醒到,当用户升级并且发现功能被破坏时,这可不太好。

Ponterelli建议解决这样问题的最佳办法是和使用你API的用户一起创建出清晰定义的迁移策略。这包括决定对于使用者的功能而言哪些兼容性必不可少,比如绝对不能失败的某个特定的功能或服务。如果无法确定完整的迁移策略,Ponterelli建议开发人员至少创建出向后兼容适配器,来帮助恢复必要的功能。

Ponterelli还建议开发人员和他们最大并且变化缓慢的客户一起开始API版本化之路,因为小型的,更为敏捷的公司通常更能接受API的变化。这给了你更多的时间来处理任何可能的问题,并且创建出需要的兼容性适配器。

4.抽象层次有所助益

除了创建可管理的兼容性,Ponterelli还建议开发人员添加反映API版本化频率的抽象层。他说Amazon创建的API,被抽象成经常变更的“细粒度”API和通常不变的“粗粒度”API。

通过这样抽象化API,你就可以帮助使用者清晰理解他们使用的API可能多久会发生变化,并且做好相应的计划。

5.考虑混合云方案

Ponterelli还指出当通过云预配API时,实现混合方案能够帮助用户抵御破坏。通过在本地保留一定数量的核心资源及其依赖,那么无论依赖的API如何变化,API用户都能够持续提供他们自己的版本。否则,他们可能会在API版本化发生的任意时间被强制要求升级,就不得不承担兼容性被破坏的风险。

我们一直都在努力坚持原创.......请不要一声不吭,就悄悄拿走。

我原创,你原创,我们的内容世界才会更加精彩!

【所有原创内容版权均属TechTarget,欢迎大家转发分享。但未经授权,严禁任何媒体(平面媒体、网络媒体、自媒体等)以及微信公众号复制、转载、摘编或以其他方式进行使用。】

微信公众号

TechTarget微信公众号二维码

TechTarget

官方微博

TechTarget中国官方微博二维码

TechTarget中国

评论
查看更多评论

敬请读者发表评论,本站保留删除与本文无关和不雅评论的权力。

API>更多

  • API项目中 官方客户端不再是可有可无的

    在API项目中,有官方支持的客户端才能给API社区传达积极的信息。没有官方支持客户的API就像是没有方向盘的汽车。可能是辆好车,但是却哪儿也去不了。

  • Google收购Apigee,焦点在于企业本身还是API?

    Axway的Suraj Kumar认为Apigee收购案不一定是件好事。尽管Google也许会像Borg一样行动,这也许预示着Google的态度需要转变。

  • Google的新收购是否意味着API变得更酷了?

    Google对API管理解决方案提供商Apigee的收购,我们应该怎么评价呢?是为了打造一个改变游戏的联盟吗?或者只是技术巨头想尽快吞食市场份额的尝试?

  • 如何创建成功的RESTful API设计

    设计好的API是一项困难的任务,存在很多主观指标。哪怕是完全拥抱RESTfulAPI设计并对其问题域拥有完整视图的小型初创企业最终也会出现命名不一致、界面模糊以及无记录语义等问题。

相关推荐

技术手册>更多

  • 松散耦合的七个级别

    在软件领域,“耦合”一般指软件组件之间的依赖程度。那么,什么是依赖?各种依赖对耦合度和松散度有多大影响?软件耦合可以发生在许多级别。必须区分生成时(编译时)依赖和运行时依赖。在分布环境中,为了确定系统的耦合程度,必须分析各个级别。下面我们就来具体看一下。

  • UDDI(统一描述发现和集成)

    UDDI统一描述、发现和集成协议,是为解决Web服务的发布和发现问题而制订的新一代基于Internet的电子商务技术标准。全称Universal Description, Discovery and Integration,它包含一组基于Web的、分布式的Web服务信息注册中心的实现标准,以及一组使企业能将自己提供的Web服务注册到该中心的实现标准。UDDI利用SOAP消息来查找和注册Web服务。并为应用程序提供了一系列接口来访问注册中心。

    UDDI(统一描述发现和集成) 提供一种发布和查找服务描述的方法。UDDI数据实体提供对定义业务和服务信息的支持。WSDL中定义的服务描述信息是UDDI注册中心信息的补充。

  • 企业IT消费化指导手册

    IT消费化是个人和商业使用的设备和应用程序的混合体。学习如何保持在前沿技术的最前端,了解工作场所内部或外部的关于IT消费化的挑战与威胁。虽然企业可以掌控在内部建立的安全机制,但是这是关于个人拥有的设备的事情,所以它需要用新方式去思考。本指南解释了IT消费化,帮助企业在IT消费化中生存,并叙述了IT消费化的影响。

  • BPEL基础使用技术手册

    BPEL是一门用于自动化业务流程的形式规约语言。 用XML文档写入BPEL中的流程能在Web 服务之间以标准化的交互方式得到精心组织。这些流程能够在任何一个符合BPEL规范的平台或产品上执行。在《BPEL基础使用技术手册》中,我们将介绍BPEL流程基础结构、BPEL可以用在哪些方面以及在在Oracle SOA套件中如何用BPEL创建复合服务。

TechTarget

最新资源
  • 安全
  • 存储
  • CIO
  • 数据库
  • 服务器
  • 云计算