跳至主要内容

OpenAPI Initiative 电子报 – 2024年4月

作者: 2024年4月4日博客, 新闻

欢迎阅读 OpenAPI Initiative (OAI) 2024年4月电子报!这是我们全新的定期汇总,涵盖 OpenAPI 全局的最新故事。我们的目标是让您了解 OpenAPI 规范的开发进展、OpenAPI Initiative 下创建的新规范以及与活动相关的新闻。

Initiative 新闻

我们很高兴地宣布,Budha Bhattacharya 担任 BGB 主席,接替 Isabelle Mauny。BGB 将 OpenAPI Initiative 的成员聚集在一起,是 Initiative 健康发展的重要论坛。

Isabelle 在过去三年里一直担任这个职位,无论是单独担任还是与他人共同担任,她的辛勤工作和奉献精神对 OpenAPI Initiative 的健康发展和成长至关重要。感谢你,Isabelle!

Budha 目前是 Tyk 的开发者布道师,拥有丰富的 OpenAPI 经验,涵盖 API 管理领域以及 API 生命周期中的各种用例。欢迎加入,Budha!

规范新闻

我们有关于规范本身及其开发团队的令人兴奋的消息!

技术指导委员会扩展

技术指导委员会 (TSC) 致力于维护 OpenAPI 规范的健康发展,发布新版本并将 OpenAPI 的价值带给社区。

TSC 最近扩大了规模,增加了四名新的临时成员

  • Ralf Handl。
  • Mike Kistler。
  • Lorna Mitchell。
  • Miguel Quintero。

这些新成员将加入现有的 TSC 成员 Marsh Gardiner、Darrel Miller、Ron Ratovsky 和 Jeremy Whitlock,他们将在维护 OpenAPI 规范的健康发展方面发挥宝贵作用,因此我们提前感谢他们的贡献!

我们还要感谢我们新晋的荣誉成员 Mike Ralphson 和 Uri Sarid,他们将从 TSC 卸任,感谢他们多年来的贡献。

规范版本

我们计划今年发布 OpenAPI 规范的新小版本 3.2,以添加一些需要进行更多修改而非补丁发布的小更改。此版本将与 3.1 严格兼容,目标是易于实现。3.1 是规范的当前稳定版本,我们计划继续向 3.x 系列添加次要版本和补丁版本,以不断改进和发展它,以满足用户的需求,并在 4.0 发布时提供平滑的迁移路径。

您可以预期会看到针对 3.0 和 3.1 的补丁版本,以更正小错误并阐明现有的 3.0.3 和 3.1.0 规范,并且无需新的实现工作来支持。

OASComply

最后,于 2023 年启动的 OASComply 合规性解析器项目将在今年继续进行。OASComply 旨在为使用 OpenAPI 规范的工具制造商提供社区支持的合规性解决方案。

在去年年底,该项目发现规范中存在一些歧义,尤其是在外部引用方面。今年,我们将努力通过新的规范版本解决这些歧义,并将 OASComply 提供给社区。要了解有关 OASComply 项目的更多信息,请访问 存储库

特别兴趣小组

我们有一些特别兴趣小组 (SIG),致力于扩展 OpenAPI 以解决特定用例。

工作流

工作流 SIG 一直在努力创建 (工作标题) 工作流规范。此新标准以结构化、确定性的方式描述 API 调用的序列。这将允许 API 提供商在 OpenAPI 中描述的不仅仅是其 API,还包括所有 API 的“协同方式”。

工作流规范目前处于候选版本阶段,1.0.0 版本即将推出。与 Moonwalk 一样,这里也提供了参与的机会

有关工作流的详细演练,请阅读 API Futures 系列中的 概述 或观看 Apidays Paris 的 演讲,均由 Frank Kilcommins 提供。我们很快将在我们的博客上发布另一个详细的演练。

Moonwalk

Moonwalk——我们的 OpenAPI 规范 v4 代码名称——自今年年初以来一直在进行中。该项目于 去年 12 月 在我们的博客上正式宣布,Marsh Gardiner 和 Darrel Miller 强调了 OpenAPI 版本 4 的目标,团队一直在努力开展工作。我们还想重点介绍 Henry Andrews 的 这篇博文,其中强调了现有版本和未来版本之间一致性的必要性,团队正在努力实现这一目标。

如果您想帮助开发 Moonwalk,您可以通过以下几种方式参与

  • 参加我们的每周会议,我们将在会议上讨论当前的进展和下一步计划(OAI 日历)。
  • 加入 Moonwalk Slack 频道
  • 查看 GitHub 讨论 并参与其中。

请记住,这是您参与 OpenAPI 规范下一个主要版本的绝佳机会。如果您有任何需求或好主意,请参与进来!

覆盖层

覆盖层标准描述了可以对 OpenAPI 描述进行的重复修改。这对于添加文档或 SDK 生成器等工具可以使用的额外数据或删除不应与 OpenAPI 描述一起发布的内部信息非常有用。

该规范处于预发布状态,并向社区征求意见和反馈。社区对此很感兴趣,一些工具也开始实施当前的标准。访问 存储库 以查看当前规范和问题讨论,并在 Slack 频道 中与我们联系。

参与进来

有许多 SIG 涵盖不同的主题和行业垂直领域。访问我们的 社区存储库 以了解更多信息。

活动

有一些即将举行的活动,OpenAPI 将在其中举办研讨会或主题演讲。您可以在 OAI 活动日历 上找到即将举行的所有活动列表。

OpenAPI 小型峰会 – 2024年4月15日

首先,我们期待着 OpenAPI 小型峰会,该峰会将于 4 月 15 日在西雅图举行,作为 北美开源峰会 (OSS NA) 的一部分举行。

我们将回顾 OpenAPI 世界中的当前发展,并提供工作流规范的详细演练,以及一些有助于将其付诸实践的示例。

注册费用仅为 5 美元,因此如果您有兴趣参加,请查看 活动注册页面(请注意:注册 OpenAPI 小型峰会需要注册 OSS NA)。

Apidays 新加坡 – 2024年4月17日至18日

我们将参加 Apidays 新加坡,由 Erik Wilde 主持 OAI 主题演讲,作为会议的一部分。我们将邀请演讲者从采用开放标准的角度以及他们如何利用 OpenAPI 确保其 API 的一致性和质量的角度,谈论 OpenAPI 在其组织中的价值。

Jax,美因茨 – 2024年4月22日至26日

我们还将在德国美因茨举办的 Jax 会议 上举办另一个 OAI 主题演讲,同样由 Erik Wilde 主持。我们将了解 OpenAPI 对 API 生态系统的重要性以及 OpenAPI 对 API 发布交付的重要性。

活动展望

还有一些活动,我们计划举办 OAI 主题演讲

请查看 OAI 活动日历,以获取即将举行的所有活动的完整列表。

最后…

本期电子报到此结束。如果您有任何新闻想要与 OpenAPI 社区分享,请通过 电子邮件 联系我们或加入 Slack 上的 外联频道