社区请求!请审查 RC1,实施它,并在 11 月 8 日之前与我们分享您的反馈。最终版本应该很快就会发布。
OpenAPI 规范 3.1 的候选版本 1 (RC1),即实施者草案,现已提供测试和评估。
这些增强功能解决了 OpenAPI 开发者社区一些最常请求的功能。具体来说,OpenAPI 规范现在完全兼容最新版本的 JSON Schema 草案。这在 OpenAPI 开发者社区和 JSON Schema 社区成员之间取得了重大进展。
更改包括
- 一个新的顶级元素,用于描述在带外注册和管理的 Webhook。非常感谢 Lorna Mitchell 推动这项工作,使用我们新的 提案流程。
- 改进对使用标准 SPDX 标识符识别 API 许可证的支持。
- PathItems 对象现在是可选的,以便于创建可重用组件的索引。可重用 PathItems 可以在 components 对象中描述。还支持描述使用客户端证书保护的 API。
您可以了解更多关于 RC1 的信息 此处。
特别感谢 Henry Andrews、Phil Sturgeon 和 Ben Hutton 的辛勤工作和支持。