OpenAPI 规范 3.1.0 发布，赶紧来尝尝鲜！

我们常说，新年新气象！这不，刚开年，各大厂商就忙着发布自己的最新产品。

之前Spring Boot发布了最新的2.4.3版本。

除了Spring Boot，OpenAPI也在近日正式发布了其最新的3.1.0版本规范。

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

本次更新是在3.1.0-rc1版本的基础上进行进一步突破性的优化，让我们一起来看看吧。

新增内容

• 添加了jsonSchemaDialect顶级字段，以允许为模式对象定义默认的$schema值。

更新内容

• 更新了一些链接到更准确的位置。
• 将JSON模式支持更新为最新的2020-12草案。
• 修改了uri和url下的相对引用解析。
• 修改了文件上传描述，以考虑新的JSON模式功能。这包含了一些突破性的变化。
• 规范扩展的x-oai和x-oas前缀现在都保留由OpenAPI进行定义。

一些解释内容

• 路径参数值不能包含未转义的字符/，？或#。
• 进一步解释应该在何处使用引用对象和JSON模式的引用。
• 统一当值为URLs/URIs时的用法。
• 重写路径项的$ref以考虑引用和组件更改。
• 修正了一些例子。
• 微小的文本更改，以提高一致性和可读性。
• 更新引用对象的描述用来进一步阐明其行为意义。
• 进一步更新了Schema对象的描述，以考虑最新的draft和默认使用spec.openapi.org/oas/3.1/dialect/base作为OAS方言。
• 将“Schema Vocabularies”改为“Schema dialects”。

来源于公众号“程序猿DD”