写点什么

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

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

关注

评论

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

YashanDB HA节点间SSL连接配置

YashanDB

数据库 yashandb

兼职招聘平台(源码+文档+讲解+演示)

深圳亥时科技

家政服务平台(源码+文档+讲解+演示)

深圳亥时科技

AI颠覆数据分析!Google最新AI产品Data Science Agent让你秒变数据科学家

小鲸数据

AI 数据分析 数据科学 AI Agent 自动化分析

两会布局的新兴和未来产业,用友一直在助力!

用友智能财务

AI 财经 用友 会计

H5 APP的性能优化

北京木奇移动技术有限公司

软件外包公司 APP外包公司 APP开发公司

三个AI思维,让你拥有碾压DeepSeek实力

小鲸数据

DeepSeek AI思维

一招解决数据库中报表查询慢的痛点

阿里技术

数据库 duckdb TP系统

YashanDB分布式节点间SSL连接配置

YashanDB

数据库 yashandb

企业为什么需要建设零信任身份安全

芯盾时代

iam 零信任 统一身份管理平台

推荐一款好用的智能工单系统,有哪些智能化应用场景

云智慧AIOps社区

ITSM ITSM软件 工单系统 智能工单

H5 APP开发框架及特点

北京木奇移动技术有限公司

APP开发 软件外包公司 H5 APP

推理大模型时代,TextIn ParseX助力出版业知识资产重构

合合技术团队

人工智能 算法 图表 图像处理 大模型

从ChatGPT到DeepSeek,现象级爆火背后的数学逻辑!

小鲸数据

YashanDB TLCP连接配置

YashanDB

数据库 yashandb

19.5stars!未来十年一定要学的免费、开源的OLAP数据库——DuckDB

遇码

大数据 开源 数据分析 OLAP duckdb

原生APP的性能优化

北京木奇移动技术有限公司

APP开发 软件外包公司 APP外包公司

淘宝淘口令API接口全攻略

tbapi

淘宝API接口 淘宝口令接口 淘口令API接口

时序数据库 IoTDB 为某大厂多领域物联网场景提供数字化管理基座

Apache IoTDB

YashanDB数据库服务端SSL连接配置

YashanDB

数据库 yashandb

MAC与HMAC技术辨析

石君

hash HMAC-SHA

【活动预告】3.15 数据与 AI 新技术论坛,徐汇西岸见!

Apache IoTDB

为什么说JSON不一定是LLM结构化输出的最佳选择?

Baihai IDP

程序员 AI LLMs 格式化数据

智能制造架构设计方案

金陵老街

智慧工厂 智能制造

【每日学点HarmonyOS Next知识】获取资源问题、软键盘弹起、swiper更新、C给图片设置位图、读取本地Json

轻口味

HarmonyOS HarmonyOS NEXT

接棒DeepSeek,Manus带来AI Agent最新工程实践

小鲸数据

AI Agent #AI Manus

招标采购系统(源码+文档+讲解+演示)

深圳亥时科技

邀请函|相约新乡——“AI 赋能,智造跃迁” AI 驱动数字化创新设计促进新质生产力发展交流会

Altair RapidMiner

AI 数字化转型 仿真 智能制造 CAE

DeepSeek大模型6大部署模式解析与探索测试开发技术赋能点

测试人

人工智能 软件测试

YashanDB操作系统身份认证配置

YashanDB

数据库 yashandb

认知、实践、驾驭:AI 时代普通人的务实生存法则

小鲸数据

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