OpenAPI 规范 3.1.0 发布,赶紧来尝尝鲜!

公众号程序猿DD

共 1177字,需浏览 3分钟

 ·

2021-02-26 18:27

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

Spring Boot发布了最新的2.4.3版本,昨天小编刚为大家介绍过,有兴趣的小伙伴点这里:Spring Boot 2.4.3、2.3.9 版本发布,你准备好了吗?

除了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和默认使用https://spec.openapi.org/oas/3.1/dialect/base作为OAS方言。

  • 将“Schema Vocabularies”改为“Schema dialects”。

具体内容可查看:https://github.com/OAI/OpenAPI-Specification/releases/tag/3.1.0

看完更新内容,小伙伴们是不是蠢蠢欲动,迫不及待体验最新版本的变化呢?也欢迎各位小伙伴将自己对本次更新的内容看法留言进行讨论!

喜欢本文的朋友,欢迎点击下方卡片
关注我,订阅更多精彩内容


往期推荐

合格的后端Coder都应该写好UT和Mock测试

Spring Boot 2.4.3、2.3.9 版本发布,你准备好了吗?

打造全球最大规模 Kafka 集群,Uber 的多区域灾备实践

“智能”坐垫记录离座时间,是高科技福利还是又一个员工压榨机器?

Java延迟加载的最佳实践应用示例!

不容错过的灰度发布系统架构设计




浏览 50
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报
评论
图片
表情
推荐
点赞
评论
收藏
分享

手机扫一扫分享

分享
举报