OpenAPI 规范 3.1.0 发布

栏目: 软件资讯 · 发布时间: 3年前

内容简介:OpenAPI Initiative 宣布发布 OpenAPI 规范 3.1.0。OpenAPI 规范是用于描述 API 的行业标准,它允许开发人员和计算机在不需要访问源代码、文档或网络流量的情况下理解 API 的功能。 3.1.0 中的更新内容包括有:与...

OpenAPI Initiative 宣布发布 OpenAPI 规范 3.1.0。OpenAPI 规范是用于描述 API 的行业标准,它允许开发人员和计算机在不需要访问源代码、文档或网络流量的情况下理解 API 的功能。

OpenAPI 规范 3.1.0 发布

3.1.0 中的更新内容包括有:与 JSON Schema 的最新草案兼容、用于描述 Webhooks 的新的 top-level element、以及对使用 SPDX 标识符识别 API 许可证的支持。此外,PathItems object 现在是可选的,这使得创建可重用的组件库更加简单。完整更新内容如下:

Additions

  • 添加了jsonSchemaDialect顶层字段,允许为 Schema Objects 定义一个默认的 $schema 值。

Updates

  • 将一些链接更新到更准确的位置。
  • 将 JSON Schema 支持更新为最新的 2020-12 草案
  • 修订了 URI 和 URL下 的 relative reference resolution。
  • 重新设计了文件上传描述,以考虑到新的 JSON Schema 功能。这包含了 breaking changes。
  • 规范扩展的 x-oai- 和 x-oas- 前缀现在都保留给 OpenAPI Initiative 定义。

Clarifications

  • Path 参数值不能包含非转义字符/?#
  • 进一步解释 Reference Object 和 JSON Schema 的引用应该用在哪里。
  • 当值是 URLs/URIs 时,Unified wording。
  • 重写了 Path Item 的 $ref,以考虑到引用和组件的变化。
  • 修复了一些例子。
  • 较小的文本更改以提高一致性和可读性。
  • Reference Object 的描述已更新,以进一步阐明其行为。
  • 进一步更新了 Schema Object 的描述,以考虑到最新的草案,以及默认使用 https://spec.openapis.org/oas/3.1/dialect/base 作为默认的 OAS 方言。
  • 将“Schema Vocabularies”改为“Schema dialects”。

除了发布版本 3.1.0,OpenAPI Initiative 还宣布赞助了新文档的创建。以帮助用户更容易、更好地理解 OpenAPI 规范的结构及其优势。

目前,OpenAPI 规范已被世界各地的组织所使用,包括 Atlassian、Bloomberg、eBay、Google、IBM、微软、Oracle、Postman、SAP、SmartBear、Vonage 等。


以上就是本文的全部内容,希望本文的内容对大家的学习或者工作能带来一定的帮助,也希望大家多多支持 码农网

查看所有标签

猜你喜欢:

本站部分资源来源于网络,本站转载出于传递更多信息之目的,版权归原作者或者来源机构所有,如转载稿涉及版权问题,请联系我们

任正非传

任正非传

孙力科 / 浙江人民出版社 / 2017-5-2 / 39.80

编辑推荐: 超权威、超丰富、超真实的任正非传记 亲述任正非跌宕起伏、传奇精彩的一生 ◆知名财经作家孙力科,历时十年,数十次深入华为,采访华为和任正非历程中各个关键人物,几度增删,创作成此书 ◆全书展现了任正非从出生至今70多年的人生画卷,从入伍到退役进国企,从艰难创业到开拓海外市场,囊括其人生道路上各个关键点,时间跨度之长,内容之丰富,前所未有 ◆迄今为止,任正非一生......一起来看看 《任正非传》 这本书的介绍吧!

JS 压缩/解压工具
JS 压缩/解压工具

在线压缩/解压 JS 代码

随机密码生成器
随机密码生成器

多种字符组合密码

MD5 加密
MD5 加密

MD5 加密工具