AICon 上海站|90%日程已就绪,解锁Al未来! 了解详情
写点什么

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

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

关注

评论

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

Bean的作用域与Bean的生命周期详解

爱好编程进阶

Java 程序员 后端开发

Docker容器重启慢?快来看看这些优雅终止方案

爱好编程进阶

Java 程序员 后端开发

GitHub上14个屌炸天的Java进阶教程、面试真题项目,建议收藏

爱好编程进阶

Java 程序员 后端开发

【愚公系列】2022年05月 二十三种设计模式(八)-组合模式(Composite Pattern)

愚公搬代码

5月月更

百万级电商秒杀架构设计

晨亮

「架构实战营」

ansible2

爱好编程进阶

Java 程序员 后端开发

如何开发LAXCUS分布式应用软件(一):前言

LAXCUS分布式操作系统

集群 并行计算 分布式操作系统 分布式应用软件

7-32 哥尼斯堡的“七桥问题” (25 分)(思路

爱好编程进阶

Java 程序员 后端开发

Day168

爱好编程进阶

Java 程序员 后端开发

Day193

爱好编程进阶

Java 程序员 后端开发

2021 企业架构(EA)状态调查报告

涛哥 数字产品和业务架构

企业架构

模块五:作业

本人法海

「架构实战营」

ElasticSearch入门(三)Logstash实现MySQL数据同步至ElasticSearch

爱好编程进阶

Java 程序员 后端开发

ftp命令解决文件的上传和下载

爱好编程进阶

Java 程序员 后端开发

全链路压测(十一):聊聊稳定性预案

老张

性能测试 全链路压测

Nacos源码系列—服务端那些事儿

牧小农

源码 nacos

【建议收藏】Mysql知识干货(mysql八股文)汇总

利志分享

面试 面试题 MySQL 数据库 面试问题 MySQL InnoDB

985硕非科班,靠着自己的努力一步一步转行拿到抖音后端offer,现在想想就觉得满足

爱好编程进阶

Java 程序员 后端开发

C++最佳实践 | 1. 工具

俞凡

c++ 最佳实践

CGBTN2108-DAY07总结复习

爱好编程进阶

Java 程序员 后端开发

python之pythonic

AIWeker

Python 人工智能 5月月更

C语言_语句与位运算练习

DS小龙哥

5月月更

CCF201509-2 日期计算

爱好编程进阶

Java 程序员 后端开发

CQRS架构

爱好编程进阶

Java 程序员 后端开发

Day262

爱好编程进阶

Java 程序员 后端开发

模块5 作业

KennyQ

Day433

爱好编程进阶

Java 程序员 后端开发

GitHub持续霸榜!2021年Java核心知识:面试突击版

爱好编程进阶

Java 程序员 后端开发

Github已标星80

爱好编程进阶

Java 程序员 后端开发

赫卡忒的眼眸:微光手机“夜视仪”是怎样炼成的?

脑极体

复杂任务中,流程的解耦设计

架构 事件驱动 任务管理 异步设计

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