OpenAPI Initiative 成员 技术指导委员会 宣布了 OpenAPI 规范 3.0.2 的最新版本。注意:此版本是修补程序版本,这些修改不会改变规范的行为。
作为修补程序版本,最新的更改是为了在可读性和准确性方面改进规范。请阅读我们 GitHub 仓库的发布说明 此处。
如果您有兴趣 参与规范开发,请在太平洋时间星期四上午 9 点加入我们,参加技术指导委员会的公开会议。
- 为地图中键的区分大小写添加了说明。
- 重新设计了数据类型表,删除了通用名称以减少潜在的混淆。
- 澄清了服务器变量对象的 default 字段的描述。
- 修复了各种示例。
- 澄清了 operationId 区分大小写。
- 澄清了参数对象的 deprecated 字段的默认值为 false。
- 建议不要使用参数对象的 allowEmptyValue 字段,因为它将在未来版本中删除。
- 修复了媒体类型对象的 schema 字段的描述。
- 澄清了响应对象的响应代码字段描述。
- 澄清了 Schema 对象的 additionalProperties 字段的默认值为 true。
- 修复了鉴别器对象描述中的一处小问题。
- 修复了安全方案对象描述,以包含对在 cookie 中使用 API 密钥的引用。
- 修复了安全需求对象的描述。