BT

如何利用碎片时间提升技术认知与能力? 点击获取答案

期待已久的OpenAPI规范3.0将在七月发布

| 作者 Shelby Switzer 关注 0 他的粉丝 ,译者 Rays 关注 3 他的粉丝 发布于 2017年7月3日. 估计阅读时间: 3 分钟 | QCon上海2018 关注大数据平台技术选型、搭建、系统迁移和优化的经验。

经过一年多的开发后,开放API战略(OAI,Open API Initiative)近期宣布将在2017年七月中旬发布OpenAPI规范(OAS,OpenAPI Specification )v3.0.0的最终版。发布前的开放征求意见阶段将在六月三十日结束。

该版本的发布得到了API社区的密切地关注,开发人员和业界领导人已经直接挑明了其中最令他们激动的特性。OAS3.0中备受关注的关键特性包括:

  • 组件;
  • 多主机支持;
  • 具备新内容属性的内容协商;
  • 支持回调和WebHooks;
  • 使用Links对象,对超媒体给出建议;
  • 改进了对JSON模式anyOf, allOf和not函数的支持。

随着规范达到了3.0,开源社区和软件厂商正致力于为自身的OAS工具提供向前兼容性。作为OAS所基于的描述性语言Swagger,其创始人Tony Tam在去年曾接受InfoQ采访,他预警了即将到来的重大改进:

很多工具软件商可以通过改进工具同时支持2.0和3.0规范。但几乎可以肯定的是,2.0版的工具将不会支持3.0规范。我们期望并鼓励各工具间实现更好的向前兼容。我们将确保将3.0规范之后的所有更新作为非重大更新对待,以取得3.x的版本号。

Darrel Miller是一名OAS技术开发人员社区(TDC,Technical Developer Community)成员,同时也是负责为规范提供技术指导的六人小组成员之一。他向InfoQ介绍了TDC在准备这次发布中所面对的主要挑战,即时间和优先级。“我们有幸能具有一些热心的社区成员,他们志愿付出了很多时间的额外努力,以帮助规范达到可发布状态。”他说,“我们的时间有限,规范的涵盖内容也有限,因此我们想在添加特性与维持规范的简单性这两者间取得平衡。我们都看到了在规范上所发生的事情,这将使规范更为复杂。但是所增加的每一点复杂度,都相应地会有用户的确需要这些功能。虽然我们很少具有拒绝某一特性,但是接收新的特性也是同等重要的。”

虽然TDC尚未明确给出下一版本OpenAPI的计划,但是TDC正在积极地讨论未来版本中准备包含哪些内容。在五月召开的GlueCon大会上,召开了一次涉及了在3.0版本中主要更改的研讨会。在该研讨会上,Miller介绍了已得到实验性支持的特性,包括可重用组、可替换模式、操作版本控制和动态枚举等。据Miller介绍,对象的可重用组是在未来更新中优先考虑的特性,而可替换模式是一个得到了广泛请求的特性,但是要确保用户在工具上具有很好的和一致的体验,这对该特性提出了重大挑战。他还指出下一版本的一个话题就是,“无论我们翘首以待的下一版本会是什么样的,我们都期待发布下一版本所需的时间将会比发布V3所用的时间更短”。

查看英文原文: Long-Awaited OpenAPI Spec 3.0 to Be Released in July

评价本文

专业度
风格

您好,朋友!

您需要 注册一个InfoQ账号 或者 才能进行评论。在您完成注册后还需要进行一些设置。

获得来自InfoQ的更多体验。

告诉我们您的想法

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我
社区评论

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

允许的HTML标签: a,b,br,blockquote,i,li,pre,u,ul,p

当有人回复此评论时请E-mail通知我

讨论

登陆InfoQ,与你最关心的话题互动。


找回密码....

Follow

关注你最喜爱的话题和作者

快速浏览网站内你所感兴趣话题的精选内容。

Like

内容自由定制

选择想要阅读的主题和喜爱的作者定制自己的新闻源。

Notifications

获取更新

设置通知机制以获取内容更新对您而言是否重要

BT