支持 OpenAPI 3.2.0 文档(独立模式)
作者: yluom创建于 2026年2月17日更新于 2026年8月7日
标签Type: Enhancement
** 说明需要解决的问题**
OpenAPI 3.2.0规格于2025年9月发布. 装入 OpenAPI 时 3.2.0文档,Redoc以"不支持的OpenAPI版本:3.2.0"拒绝. 此屏蔽任何已升级其 API 的项目 向美洲国家组织提供与Redoc的文件的合同。
说明你想要的解决方案
Redoc应该分析并制作出OpenAPI 3.2.0文档,其处理方式与今天的3.0.x和3.1.x相同. 由于3.2是未成年人 3.1以上的递增,核心渲染逻辑需要最小的修改——主阻断器似乎是版本. 审定验收.
起码:
- 在版本检查中接受`openapi: 3.2.x'
- 优雅地处理任何新的3.2特定构件(降级而不是错误,如果尚未得到充分支持)
** 说明你考虑过的备选办法**
- ** 将光谱降为3.1.0**——工作,但防止使用3.2个特性和力量,与来源存在差异。 事实
- Using Swagger UI——支持3.2,但缺乏Redoc提供的单页渲染和定制.
- ** 重新编制CLI
审查'——CLI已开始增加3.2项支持,但重新编制'本身尚未从中受益。
** 其他情况**
- 相关:2746
Redocly-cli'已经开始增加3.2支持(参见参考PR),但Redoc'尚未收到这些修改。- 美洲组织3.2基本上与3.1相向后兼容,因此,一个务实的第一步可能是将版本大门放宽到 " 3.2.x " 并逐渐增加全力支持.
内容来源: Redocly/redoc