写点什么

期待已久的 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:002418
用户头像

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

关注

评论

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

请谈下Android消息机制,成功拿下大厂offer

欢喜学安卓

android 程序员 面试 移动开发

向大佬学习!「mybatis查询匹配机制」,手动点赞

java小李

java 14 Mybati

GitHub标星139K的:“嵌入式Linux系统开发教程”

白亦杨

《分享几道高频 Redis 高频面试题,面试不用愁》

java小李

Redis Stream

一条SQL语句执行得很慢的原因盘点

北游学Java

Java MySQL

技术解码 | GB28181协议简介及实践

腾讯云音视频

腾讯云 ffmpeg 流媒体 视频监控系统

解决方案| 全民抗“灾”- 实时音视频在应急指挥场景的应用

anyRTC开发者

音视频 WebRTC 指挥调度

速来围观!大佬把Java基础核心知识整理成了PDF版

java小李

Java开发手册 Java 开发

深度融合,云管理平台助推政府实现“最多跑一次”改革

BoCloud博云

云计算 云管理平台 云管理

FBI 警告称,网络犯罪分子可能以 2021 年东京奥运会为目标!

郑州埃文科技

如何借用第三方APM工具, 为移动应用保驾护航

APM

DAPP智能合约开发|智能合约搭建

Geek_23f0c3

区块链 智能合约 DAPP智能合约交易系统开发 DAPP系统开发

Recommending movies: retrieval

毛显新

tensorflow 推荐系统

架构实战营-模块三

Cingk

最新流行的6大优秀DevOps工具

java小李

java 14 puppeteer

淘宝一面:说一下 Spring Boot 自动装配原理呗?

java小李

面试 java 14 sping

Vue进阶(九十四):自定义组件

No Silver Bullet

Vue 自定义组件 7月日更

《MyCat数据库的基础配置及使用》

java小李

java 14 mycat

拨云开雾!阿里面试官力荐Java开发必看的操作系统底层原理PDF

Java架构追梦

Java 阿里巴巴 架构 面试 操作系统

行云创新完成B轮融资,阿里云独家投资

行云创新

阿里云 云原生 投资

被面试官问的Android问题难倒了,深度集成!

欢喜学安卓

android 程序员 面试 移动开发

被转载10W次的:Java小白系统资料和职业规划路线

java小李

java基础

基于 Java Spring Security 的关注微信公众号即登录的设计与实现ya

哈德韦

spring security 微信公众号 Apache Pulsar SSO

对象存储手把手教三 | 数据分段上传

QingStor分布式存储

对象存储 分布式存储 数据传输

DeFi智能合约DAPP开发|DeFi项目源码

Geek_23f0c3

DeFi去中心化系统开发 DAPP智能合约交易系统开发

携生态伙伴展示AI计算盒参考设计最新成果 英特尔点亮智能边缘广阔机遇

E科讯

幸福的人在当下就活出了幸福的样子|靠谱点评

无量靠谱

面试题:JVM在Java堆中对对象的创建、内存结构、访问方式

java小李

java 14 sping

大学四年Java学习路线规划,所有私藏资料我都贡献出来了

java小李

spring Java web

华为助力高校释放能量,加速中国从开源使用大国向贡献大国转变

科技热闻

架构训练营模块3课后作业-学生管理系统详设文档

喻高咏        

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