写点什么

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:0011767
用户头像

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

关注

评论 1 条评论

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

OBV指标交易策略(累积能量潮与移动能量潮,成交量多空比率净额及相关应用原则)

程序媛可鸥

Python 程序员 面试

python DataFrame数据分组统计groupby()函数,值得推荐

程序媛可鸥

Python 程序员 面试

Python两个内置函数locals 和globals,Python项目开发如何设计整体架构

程序媛可鸥

Python 程序员 面试

Newton迭代法开方(Python),最详细的docker中安装并配置redis

程序媛可鸥

Python 程序员 面试

架构实战营模块六作业

刘洋

#架构实战营 「架构实战营」

Python数据类型——字典,一次哔哩哔哩面试经历

程序媛可鸥

Python 程序员 面试

18年程序员生涯,读了200多本编程书,挑出一些精华分享给大家

程序媛可鸥

Python 程序员 面试

Python实现Singleton模式的几种方式,正在准备面试

程序媛可鸥

Python 程序员 面试

解密GaussDB(for Influx)时序洞察

华为云开发者联盟

Influxdb 时序数据库 GaussDB(for Influx) 时序数据 时序洞察

Girlfriend含苞待笑——一次性处理上百份文档,BAT这种大厂履历意味着什么

程序媛可鸥

Python 程序员 面试

Python3通过函数名调用函数的几种场景实现,贼厉害

程序媛可鸥

Python 程序员 面试

python中函数作用域,高级Python开发面试解答之线程篇

程序媛可鸥

Python 程序员 面试

详解《send》源码中NodeJs静态文件托管服务实现原理

CRMEB

Python 中的八个“无代码”特性,这原因我服了

程序媛可鸥

Python 程序员 面试

Python 中进程和线程的用法基本一样,跪了

程序媛可鸥

Python 程序员 面试

Linux grep命令详解,手把手教你写

程序媛可鸥

Python 程序员 面试

百度一线工程师浅谈日新月异的云原生

百度Geek说

云原生 后端

Python 下载的9种方法,如何才能通过一线互联网公司面试

程序媛可鸥

Python 程序员 面试

python中strip(),lstrip(),rstrip()函数的使用讲解,Python开发知识点

程序媛可鸥

Python 程序员 面试

【技术加油站】揭秘百度智能测试规模化落地

百度Geek说

百度 测试 后端 智能化测试

百度交易中台之账房系统架构浅析

百度Geek说

百度 架构 后端 交易中台

复盘归因,提高交付质量的秘诀

老张

软件测试 交付质量 复盘归因

Python 金融量化 随机指标交易策略,闭关60天学懂NDK+Flutter

程序媛可鸥

Python 程序员 面试

Python数据分析 之 制作酷炫的可视化大屏,特简单,我把所有Python框架整理成了PDF

程序媛可鸥

Python 程序员 面试

想了解 spring-cloud-kubernetes,那就先来实战一把官方demo

华为云开发者联盟

spring Kubernetes Spring Cloud Spring Boot

Matlab初级学习者,15个经典面试问题及回答思路

程序媛可鸥

Python 程序员 面试

NFS服务器原理、搭建、配置,Python面试题选择题

程序媛可鸥

Python 程序员 面试

Python 蜻蜓fm有声书批量下载 支持账号登录 原创源码,斩获offer

程序媛可鸥

Python 程序员 面试

Python数据结构与算法(2,阿里一线架构师技术图谱

程序媛可鸥

程序员 面试

15 本你必须阅读的 PyTorch 书籍,【2021Python最新学习路线

程序媛可鸥

Python 程序员 面试

Python 中的文本分类,2021Python面试真题精选干货整理

程序媛可鸥

Python 程序员 面试

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