OpenAPI 规范 3.1.0 发布,赶紧来尝尝鲜!
发布 规范 3.1 赶紧 OpenAPI
2023-06-13 09:18:15 时间
我们常说,新年新气象!这不,刚开年,各大厂商就忙着发布自己的最新产品。
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
看完更新内容,小伙伴们是不是蠢蠢欲动,迫不及待体验最新版本的变化呢?也欢迎各位小伙伴将自己对本次更新的内容看法留言进行讨论!
喜欢本文的朋友,欢迎点击下方卡片
关注我,订阅更多精彩内容
往期推荐
Spring Boot 2.4.3、2.3.9 版本发布,你准备好了吗?
打造全球最大规模 Kafka 集群,Uber 的多区域灾备实践
相关文章
- 微软发布windows 8 Logo认证硬件规范
- Week32-脚手架组件发布功能开发
- Stable Diffusion 2.1版本发布,涩图功能回来了?
- 如何规范地发布一个现代化的 NPM 包?
- 灰度发布和AB Test有什么关系?
- AI,让增长变简单:汇量科技官宣朱小强加盟,发布全域营销云产品矩阵「热力引擎」
- 谷歌秋天发布安卓9 甜品名或为“凤梨酥”详解手机开发
- TurnKey Linux 16.0 稳定版发布
- 首个开放汽车级 Linux 规范 AGL 发布
- OpenSSH 7.2 发布,支持 SHA-256/512 的 RSA 签名
- 苹果发布 ARKit 之后,这家成都计算机视觉公司的大门被挤爆了
- 腾讯发布Q3财报,金融业务会成为下一个增长引擎吗?
- VRDC 2016 〡Lucky’s Tale 开发商发布 VR 社交项目“仙境”
- 多数据表共用一个页的新闻发布