OpenAPI 规范 v3.0.0 正式版即将发布。如果您一直等待开始试用 OpenAPI 规范 (OAS) v3.0.0(前身为 Swagger),现在正是开始原型设计或编码的好时机。**请将您的日历标记为从 6 月 19 日(星期一)到 6 月 30 日(星期五)为期两周的最后评论期**,并在 7 月份关注最终版本的发布。
3 月 1 日,OpenAPI Initiative (OAI) 宣布 发布了第一个 OpenAPI 规范 v3.0.0 实现者草案。此版本标记为 3.0.0-rc0,我们在 4 月底发布了后续版本,标记为 3.0.0-rc1。
在 5 月 19 日(星期五)的会议上,技术开发人员社区 (TDC) 同意将发布计划定为以下时间表
- 从 5 月 22 日到 6 月 16 日的 4 周:解决剩余的拉取请求
- 从 6 月 19 日到 6 月 30 日的 2 周:评论期
- 从 7 月 3 日到 7 月 14 日的 2 周:解决剩余的评论和问题
- 从 7 月 17 日到 7 月 21 日的 1 周:暂定发布窗口
如果您没有收到 OpenAPI 规范存储库中每次更改的移动设备推送通知,以下是一些有用的链接
- 最新 v3.0.0 规范草案
https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.md - 打开的拉取请求
https://github.com/OAI/OpenAPI-Specification/pulls - 贡献
https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/CONTRIBUTORS.md - OpenAPI 规范 v3.0.0 中更新的一些亮点
https://www.openapis.org.cn/blog/2017/01/24/a-new-year-a-new-specification - OpenAPI 规范 v3.0.0 系列简介
https://www.openapis.org.cn/specification/v3insights
如上所述,**如果您尚未这样做,现在是审查最新 OpenAPI 规范 v3.0.0 的好时机**,考虑您的系统和工具如何利用 新功能,并在 v3.0.0 正式版发布之前考虑是否有任何可以改进的地方。
最后,如果您正在编写任何以任何方式使用 3.0 草案规范的工具,请通过完成此 非常简短的调查 告知我们,因为只有通过针对草案规范实现代码,我们才能对其准备情况充满信心!