通过这篇博文,我们开启了 OpenAPI 规范 v3 的为期两周的最后征求意见期。OpenAPI 规范 v3。
如上月所述上个月,OpenAPI 规范 v3 现已进入最后征求意见期。您可以在以下地址找到 OpenAPI 规范 v3 的最新发布候选版本:https://github.com/OAI/OpenAPI-Specification/releases
在 6 月 16 日星期五的会议上,技术开发者社区 (TDC) 确认了以下日期
- 从 5 月 22 日到 6 月 16 日的 4 周:解决剩余的拉取请求
- 从 6 月 19 日到 6 月 30 日的 2 周:意见征集期 ← 您现在所处的位置
- 从 7 月 3 日到 7 月 14 日的 2 周:解决剩余的意见和问题
- 从 7 月 17 日到 7 月 21 日的 1 周:发布窗口(暂定)
无论您自 v2.0 以来是否没有查看过规范,或者是否将 v3.0.0-rc1 的磨损副本放在键盘旁边,这都是您影响规范草案在发布之前的最佳机会。
以下是一些您可以提供反馈的方式
- 拉取请求 – 如果您有一个相对简单的更改,请在 GitHub 上提交拉取请求 (PR):https://github.com/OAI/OpenAPI-Specification/blob/OpenAPI.next/versions/3.0.md
- 问题:如果您有更一般的反馈,您可以提交问题:https://github.com/OAI/OpenAPI-Specification/issues
该OpenAPI 规范 v3处于“发布候选”阶段。意见特别有帮助的几个方面是示例的清晰度和功能的描述。欢迎提出新功能或对现有功能进行重大更改的建议,但很可能仅在将来的版本中予以考虑。
注意:TDC 成员表示更喜欢拉取请求,因为它使意图更清晰,并且因为所有更改最终都必须通过该阶段。如果您无法提交 PR,则问题是次佳选择。
如果您想全面了解 OpenAPI 规范 v3,请查看
- OpenAPI 规范 v3 系列简介:https://www.openapis.org.cn/specification/v3insights
正在播放: Semisonic 的《Closing Time》