写点什么

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

  • 2017-07-02
  • 本文字数:1066 字

    阅读完需:约 3 分钟

经过一年多的开发后,开放 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

2017-07-02 19:002780
用户头像

发布了 227 篇内容, 共 83.0 次阅读, 收获喜欢 28 次。

关注

评论

发布
暂无评论
发现更多内容

流量控制算法

架构 流量控制 流控算法

架构师训练营第六周课后总结

Cloud.

看动画学算法之:排序-选择排序

程序那些事

数据结构 算法 动画

隐私计算:实现数据价值释放的突破口

CECBC

密码学 政策扶持 隐私计算 发展现状

ARTS Week8

时之虫

ARTS 打卡计划

区块链想要拥有互联网级的用户体验,如何从应用层与公链去改进?

CECBC

区块链技术助力打造新公益样板

CECBC

学习Rust,我的一些体会

Kurtis Moxley

编程 rust 随笔杂谈

手写一个Vue风格组件

林浩

Java 大前端 webpack

命令行一键启动Hadoop集群

我是个bug

大数据 hadoop hdfs YARN Big Data

个人博客网站搭建

北漂码农有话说

Swift十年

SwiftMic

Swift十年

性能压测的时候,系统响应时间和吞吐量如何变化,为什么?

不在调上

解决火狐新窗口打开网页被拦截问题

Lee Chen

大前端

可读代码编写炸鸡八 - 变量兜兜转转像是一场梦

多选参数

代码 代码组织 代码规范 可读代码编写 可读代码

使用 Docker 部署 Django + MySQL 8 开发环境

AlwaysBeta

MySQL django Docker Dockerfile Docker-compose

redis系列之——数据持久化(RDB和AOF)

诸葛小猿

redis 持久化 aof rdb

生活困境

落曦

架构师训练营架构第七周总结

Cloud.

番外篇:新鲜上市的Unicorn - Pinterest的数据系统

顾仲贤

week7

不在调上

CECBC区块链专委会副主任吴桐受邀成为伏羲智库兼职研究员

CECBC

区块链技术 吴桐 商务部CECBC 伏羲智库 政务链

Windows Sandbox

Dare Devor

Sandbox Virtualization

那些好用的命令

北漂码农有话说

云原生技术栈的关键技术

李英俊

云原生 Go 语言

LeetCode 题解:1051. 高度检查器,JavaScript,先排序再比较,详细注释

Lee Chen

大前端 LeetCode

第七章作业

小胖子

kubernetes 集群安装(kubeadm)

小小文

Docker Kubernetes 群集安装 etcd

【总结】性能优化

小胖子

看动画学算法之:排序-归并排序

程序那些事

Java 算法 排序 归并排序

盘点本周区块链国内大事件

CECBC

期待已久的OpenAPI规范3.0将在七月发布_语言 & 开发_Shelby Switzer_InfoQ精选文章