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






加入 OpenAPI Initiative 以及数百名 API 开发人员、策略师和思想领袖,参加
Cristiano 是一位开发者体验设计师,帮助大小公司改进其开发者入职、激活和支持工作。他喜欢查看出色的开发者入职流程,分析并记录常见设计实践的最佳实践和缺陷。尽管他拥有 15 年以上的开发经验,但他认为,从根本上讲,我们所有人都在某些事情上是新手,文档和入职应该反映这种理念。在过去,他曾担任承包商、初创公司创始人、活动组织者以及 PayPal 的开发者倡导者。
Virginia Eubanks 是纽约州立大学奥尔巴尼分校的政治学副教授。她是《自动化不平等:高科技工具如何对穷人进行画像、管控和惩罚》、《数字死胡同:为信息时代中的社会正义而战》一书的作者;以及与 Alethia Jones 合著的《绝不会让任何人改变我:与芭芭拉·史密斯一起建设运动 40 年》一书的合编者。她关于科技和社会正义的著作发表在《美国展望》、《民族》、《哈珀》和《连线》等杂志上。二十年来,Eubanks 一直致力于社区科技和经济正义运动。今天,她是“我们的数据之躯”项目的发起人,也是新美国基金会的成员。她住在纽约州特洛伊。
凯特·奥尼尔,被称为“技术人文主义者”,是 KO Insights 的创始人兼首席执行官。 KO Insights 是一家屡获殊荣的思想领导力和咨询公司,帮助企业、组织和城市基于人类行为和数据做出与未来一致的、有意义的决策。凯特是包括《像素与场所:连接物理和数字空间中的人类体验》在内的三本书的作者,她经常在行业会议和私人活动上发言,进行主题演讲,参与小组讨论,并为各种规模的团队主持创意头脑风暴研讨会。她的专业知识已在 CNN Money、时代周刊、福布斯、今日美国、男士杂志、英国广播公司以及其他国家和国际媒体中被报道。凯特之前的角色包括在 Netflix 创建第一个内容管理职位,领导 Magazines.com 的前沿在线优化工作,开发东芝美国的第一个内部网,建立伊利诺伊大学芝加哥分校的第一个部门网站,并在各种数字内容和科技初创公司担任领导职位。她也是 [meta]marketer 的创始人兼首席执行官,这是一家数字策略和分析机构。凯特是科技、创业和领导力领域女性的积极倡导者,她被 Google 特别选入其为女性创业者举办的全球宣传活动的启动仪式。