10 月 23 - 25 日,QCon 上海站即将召开,现在购票,享9折优惠 了解详情
写点什么

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

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

关注

评论

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

架构师训练营第 10 周学习总结

netspecial

极客大学架构师训练营

美团架构师总结整理的这份GitHub标星150K+的神仙笔记,我花了两个月肝完成功面进了阿里定级P7,现在分享出来希望大家也能有所提升!

Java架构之路

Java 程序员 架构 面试 编程语言

食堂就餐卡系统设计

我们新四军不拿群众一针一线

架构师训练营 -week10-总结

大刘

极客大学架构师训练营

EMAS 移动 DevOps 解决方案 —— Mobile DevOps

移动研发平台EMAS

阿里云 DevOps 运维 开发 emas

5G矿山,工业真金,以及智能体矿井

脑极体

涨薪神作!华为内部操作系统与网络协议笔记爆火,这也太香了吧

Java架构之路

Java 程序员 架构 面试 编程语言

深入内核,拒绝蒙圈!阿里巴巴一位P7级架构师总结整理的这份《Java架构成长笔记》彻底火了。

Java架构之路

Java 程序员 架构 面试 编程语言

架构方法

raox

极客大学架构师训练营

一文带你了解两种Transformer文字识别方法

华为云开发者联盟

人工智能 AI 文字识别

《迅雷链精品课》第八课:迅雷链多链结构

迅雷链

区块链

一周信创舆情观察(11.16~11.22)

统小信uos

【得物技术】供应链库存幂等实战分享

得物技术

幂等 供应链 得物技术部 实战 得物

“通证经济”实质是生产关系的变革

CECBC

通证经济

通过python基于netconf协议获取网络中网元的配置数据,助力企业网络控制自动化轻松实现!

华为云开发者联盟

通信 企业 网络自动化

区块链数字版权应用落地开发,区块链版权溯源解决方案

13530558032

Week 1 学习总结

J

极客大学架构师训练营

清华大佬马士兵告诉你从阿里P5级一直学到P8架构师的成长路线+视频教程!

比伯

Java 编程 架构 面试 计算机

如何保障企业数据资产的全生命周期安全?看这篇就够了

华为云开发者联盟

数据 数据资产 数据安全

分享一份大佬的MySQL数据库设计规范,值得收藏

小Q

学习 架构 面试 JVM 多线程

ThinkPad X1 Carbon与MacBook有何不同?不止是专业

E科讯

架构师训练营第一周UML图

Geek_xq

跨国区块链投资 花式“割韭菜”骗光你的钱

CECBC

区块链

有了它,数据库也能空中加油,一边迁移一边跑起来

数据君

数字时代,如何跟上互联网医院的建设潮?

CECBC

数字化医疗

去“测试”下的测试重生,不为焦虑买单

陈磊@Criss

软件测试 自动化测试 测试开发 智能化测试

架构师训练营第一周架构方法学习总结

Geek_xq

如何保护视频资源?这几个防盗链使用技巧你一定要知道!

腾讯云音视频

音视频 防盗链 内容安全 视频防盗 视频资源防盗

从数据库巨人身上撕开一道口子

数据君

腾讯云数据库登陆印尼,金融行业显神威

数据君

tdsql

区块链跨境溯源平台搭建,助力跨境电商防伪溯源

13530558032

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