跳至主要内容

OpenAPI Initiative 的技术指导委员会发布 OASv3.0.2

作者: 2018 年 10 月 8 日2018 年 10 月 9 日博客

OpenAPI Initiative 的成员 技术指导委员会 宣布发布 OpenAPI 规范 3.0.2 的最新版本。注意:此版本是补丁版本,这些修改都不会改变规范的行为。

作为补丁版本,最新更改旨在提高规范的可读性和准确性。请阅读我们 GitHub 仓库上的发布说明 此处

如果您有兴趣 参与规范的开发,请在太平洋时间每周四上午 9 点加入我们,参加技术指导委员会的公开会议。

  • 对映射中键的区分大小写进行了澄清。
  • 重构了数据类型表,删除了通用名称以减少潜在的混淆。
  • 澄清了服务器变量对象默认字段的描述。
  • 修复了各种示例。
  • 澄清了 operationId 区分大小写。
  • 澄清了参数对象弃用字段的默认值为 false。
  • 建议不要使用参数对象的 allowEmptyValue 字段,因为它将在未来版本中移除。
  • 修复了媒体类型对象 schema 字段的描述。
  • 澄清了响应对象响应代码字段描述。
  • 澄清了模式对象 additionalProperties 字段的默认值为 true。
  • 修复了鉴别器对象描述中的一个小问题。
  • 修复了安全方案对象描述,包括对在 cookie 中使用 API 密钥的引用。
  • 修复了安全需求对象描述。