写点什么

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

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

关注

评论

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

互联网券商系统搭建建议书

软件开发大鱼V15988750073

国际配售 港股交易系统开发 证券交易系统 IPO系统开发 金融平台搭建

释放数字化活力 高质量建设数字中国

CECBC

数字经济

企业工作流设计原则及多项目整合开发注意事项

Marilyn

敏捷开发 工作流 企业开发

入坑 docsify,一款神奇的文档生成利器!

沉默王二

docsify

32核打赢AMD64核 英特尔Ice Lake为HPC提供强劲性能

E科讯

数字人民币究竟是什么

CECBC

数字货币

DataOps系列丨DataOps的组织架构与挑战

DataPipeline数见科技

大数据

MySQL 连接为什么挂死了?

华为云开发者联盟

微服务 数据 存储

《迅雷链精品课》第六课:主流区块链数据存储分析(一)

迅雷链

区块链

【得物技术】浅谈分布式事务中间件Seata

得物技术

开源 分布式事务 中间件 解决方案 seata

输入法B端市场转化:百度推动产业智能化的新路径

脑极体

Scrum指南这么改,我看要完蛋!

华为云开发者联盟

Scrum 敏捷 改版

AI技术在音乐类产品中的应用场景

HIFIVE音加加

人工智能 AI 音乐 音乐制作

架构师训练营 1 期 - 第九周 - 性能优化 3

三板斧

3年Java开发经验从阿里、美团、滴滴面试回来,想和Java程序员谈一谈感悟及面经

Java架构之路

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

一周信创舆情观察(11.9~11.15)

统小信uos

第九周学习性能优化 3 总结

三板斧

极客大学架构师训练营

DataOps系列丨数据的「资产负债表」与「现状」

DataPipeline数见科技

大数据

前嗅教你大数据——史上最全代理IP服务商对比

前嗅大数据

大数据 数据采集 动态代理 静态代理 代理IP

【JDD京智大咖说】AI 未来,路在何方?NLP、CV 技术的探索与展望

京东科技开发者

人工智能 CV nlp

微服务手册:高速查询?除了Redis我们还有另外的选择

互联网应用架构

redis 微服务 springboot Caffeine 高速缓存

DataOps系列丨DataOps理念与设计原则

DataPipeline数见科技

大数据

JVM运行时数据区,你真得好好学一学

Simon郎

JVM Java 分布式

6. 自定义容器类型元素验证,类级别验证(多字段联合验证)

YourBatman

Hibernate-Validator Bean Validation 多字段联合验证

号外!5G+X联创营华为云官网上线,5G 创业春天来了!

华为云开发者联盟

华为 程序员 AI 5G

京东T8Java架构师总结整理的15w字的Java面试手册,2021年金三银四不愁涨不了薪!

Java架构之路

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

阿里P8架构师吐血整理的《SpringBoot+Vue全栈开发实战》文档资料

Java架构之路

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

架构师训练营 W05 作业

Geek_f06ede

DataPipeline 王睿:业务异常实时自动化检测 — 基于人工智能的系统实战

DataPipeline数见科技

大数据

架构师训练营 1 期 -- 第九周作业

曾彪彪

极客大学架构师训练营

区块链+供应链,双链融合开启新时代

CECBC

区块链 供应链物流

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