【AICon】探索RAG 技术在实际应用中遇到的挑战及应对策略!AICon精华内容已上线73%>>> 了解详情
写点什么

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

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

关注

评论 1 条评论

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

架构实战营模块四作业

Evan

云原生-模块二-httpserver

hunk

关注和欣赏孩子们

圣迪

孩子 自驱型成长 抑郁症

架构实战营模块四作业

lchx08

「架构实战营」

【架构实战营】模块四:知识点总结

wgl

「架构实战营」

在线HTML5,CSS3,VueJS,jQuery运行测试练习工具

入门小站

工具

架构实战训练营-模块6-作业

温安适

「架构实战营」

架构训练营 - 模块四作业

伊静西蒙

架构师第四课作业

墨宝

模块四课程作业

李晓笛

模块四作业-考试试卷存储方案

CH

架构实战营 #架构实战营

Java常用类大讲解!1️⃣(手写API、源码必备)

XiaoLin_Java

1月月更

架构实战营 - 模块 4 课后作业

tony

架构实战营模块四作业

zhongwy

「架构实战营」

千万级学生管理系统的考试试卷存储方案

AUV

「架构实战营」

【架构实战营】模块四:命题作业

wgl

「架构实战营」

Linux之chgrp命令

入门小站

架构实战营-模块四作业

木几丶

「架构实战营」

学习总结 2021.12.31

mj4ever

学习笔记

学习Python一年,这次终于弄懂了浅拷贝和深拷贝

宇宙之一粟

Python 浅拷贝和深拷贝 1月月更

040022-week2-algorithm

InfoQ_70156470130f

ArrayList与Vector比较

JavaEdge

1月月更

C#种Dispose和Close有什么不同

喵叔

1月月更

模块四作业

novoer

「架构实战营」

架构训练营模块四作业

沈益飞

架构训练营 架构师训练营 4 期

架构实战 模块四作业

mj4ever

架构实战

给前端的docker 10分钟真 · 快速入门指南

久违

Docker Vue 前端

模块四作业

Anlumina

架构实战

千万级学生管理系统的考试试卷存储方案

糖糖学编程

架构实战营

作业:架构实战营模块 4

Poplar89

「架构实战营」

架构实战营:模块五作业

Poplar

「架构实战营」

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