写点什么

OpenAPI 规范 3.0 版接近最终发布

  • 2017-02-03
  • 本文字数:739 字

    阅读完需:约 2 分钟

“开放API 战略” (Open API Initiativev) 发布了 OpenAPI 规范 3.0 版的预览,并规划于今年二月底发布实施草案(Implementer Draft)。

新的 OpenAPI 规范 3.0 带来了如下重大改进

  • 为实现更好的可重用性,对规范的整体架构进行了重构,重构后的架构如下图所示。
  • 支持 oneOf、anyOf 和 not 的 JSON 模式。
  • 可使用模式的参数。
  • 引入了 Cookie 参数,去除了 dataForm 参数。
  • 具有自身实体的主体参数(Body Parameter)。
  • 可协商的内容类型。
  • 多主机支持。
  • 简化了安全定义,改进的 WebHooks 不再通过回调机制描述。

“开放 API 战略”作为负责规范开发的组织,计划在今年二月底前给出首个实施草案。

已公布的 OpenAPI 规范目标是:

定义标准的、独立于语言的指向 REST API 的接口,使得服务能力无需访问源代码、文档,或是借助于网络流量检查,就可被人类和计算机发现并理解。通过对 OpenAPI 做适当定义后,消费者可使用最小数量的实现逻辑理解远程服务,并与远程服务交互。

OpenAPI 基于 Swagger 2.0 构建,Swagger 是 SmartBear 贡献给 Linux 基金会的。意在构建具有中立管理模型的新组织,以引领 Swagger 更上一层楼。“开放 API 战略”的创始成员包括对贡献具有兴趣的 Google、IBM 和 Microsoft。同时还成立了一个技术开发者社区(TDC,Technical Developer Community)以对规范做开发。TDC 对于任何有意向做出贡献的个人都是开放的,无需会员身份。

在对“上百个任务单和上千条评论”近一年的处理工作后,现在 OpenAPI 规范已接近于最终发布,不会再有任何其他重大改进。

查看英文原文: The OpenAPI Spec Reaches 3.0


感谢刘志勇对本文的审校。

给InfoQ 中文站投稿或者参与内容翻译工作,请邮件至 editors@cn.infoq.com 。也欢迎大家通过新浪微博( @InfoQ @丁晓昀),微信(微信号: InfoQChina )关注我们。

2017-02-03 18:0011402
用户头像

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

关注

评论 1 条评论

发布
用户头像
OpenAPI 规范 (中文版) 查看地址:https://openapi.apifox.cn/
2021-08-01 19:59
回复
没有更多了
发现更多内容

诊所数字化:诊所私域直播

boshi

直播带货 数字化医疗 七日更 28天写作

架构师训练营 4 期 第9周

引花眠

架构师训练营 4 期

作业 - 第四章 业务流程与产品文档 (二)

hao hao

c++基本语法详解

张鹤羽

28天写作 3月日更

第四章作业(二)

墨狂之逸才

SwiftUI数据流之StateObject& ObservedObject探讨

kingnight_pig

ios swift SwiftUI

浅谈JVM 垃圾回收原理

跳蚤

易语言使用与研究

慕容

易语言

我眼中的IT售前工作

Geek_dn82ci

云计算 职场 解决方案 售前

mybatis的通用插入更新方案

altantisor

Java mybatis

论文阅读:通过动态预测/完备在稀疏知识图谱上进行多跳推理

Alocasia

自然语言处理 深度学习 nlp 强化学习

最值得阅读的数据仓库书籍推荐

白程序员的自习室

大数据 数据仓库 推荐书籍 数仓 构建模型

SQL Server 多表数据增量获取和发布 1

happlyfox

学习 28天写作 2月春节不断更

业务中台建设 - 4种部署模式

孝鹏

部署图 隔离性 中台架构

用例2

z

Java 中 Vector 和 SynchronizedList 的区别

看山

Java 线程安全 vector SynchronizedList

(28DW-S8-Day9) 区块链如何对坏节点容错:拜占庭将军问题

mtfelix

28天写作 拜占庭容错 拜占庭将军

架构设计篇之微服务实战笔记(九)

小诚信驿站

架构师 刘晓成 小诚信驿站 28天写作

2.2 Go语言从入门到精通:Go语言变量

xcbeyond

变量声明 28天写作 Go 语言

区块链与数字货币的发展到底有什么意义

CECBC

数字货币

MySQL连接超时关闭问题解决

flyer0126

MySQL MySQL优化

Linux入门篇 —— 一文带你彻底搞懂Linux 文件权限管理

若尘

Linux 权限 linux 文件权限控制

一文搞懂Cookie、Storage、IndexedDB

执鸢者

大前端 Cookie indexedDB storage

SwiftUI数据流之State&Binding

kingnight_pig

ios swift SwiftUI

区块链架构下的智慧城市发展加速

CECBC

信息安全

产品经理训练营知识汇总

SilentMacUser

产品经理 产品经理训练营 邱岳

“他者”德意志(三):“翻险峰”的德国电动汽车产业

脑极体

dubbo 源码 v2.7 分析:SPI机制

程序员架构进阶

Java spi 七日更 28天写作 2月春节不断更

数字经济发展的时代特色

CECBC

数字经济

谈学习

Ryan Zheng

学习方法

【LeetCode】单调数列Java题解

Albert

算法 LeetCode 28天写作 2月春节不断更

OpenAPI规范3.0版接近最终发布_开源_Abel Avram_InfoQ精选文章