欢迎阅读 OpenAPI Initiative 2024年6月新闻通讯,这是我们定期汇总的 OpenAPI 全局最新资讯。
倡议新闻
我们很高兴地宣布 Arazzo 规范的 1.0.0 版本!Arazzo 是工作流规范的新官方名称,该名称是在经过多轮讨论后由社区决定的。Arazzo 是一种规范,允许 API 提供商描述 API 调用的序列,无论是在一个 API 中还是跨多个 API,并提供将它们链接在一起的方法,以便实施者可以根据已知的成功和失败标准编排一系列步骤。Arazzo 是描述日益复杂的 API 环境的重要一步。您可以在我们的公告中了解更多关于 Arazzo 的信息。
Arazzo 规范的发布意味着 OpenAPI Initiative 正在转向多规范组织,OpenAPI 规范和 Arazzo 规范都属于 OpenAPI Initiative 的范畴。这将改变我们如何一致地维护规范,尤其是在未来添加更多规范时。我们将在未来的文章中更详细地讨论这一点,该文章将描述我们不断变化的格局和治理方法。
如果您想知道:Arazzo 在意大利语中意为“挂毯”,之所以选择它是因为该规范既关乎将较小的事物复杂地编织在一起,也关乎讲述一个最终比其各个部分之和更大的故事。
规范新闻
随着 3.0 和 3.1 分支的计划修补程序版本即将发布,OpenAPI 规范项目正处于“澄清阶段”。这些更改解决了常见问题和困惑,以确保规范尽可能清晰。我们还改进了将规范从存储库中维护的 Markdown 源发布为 HTML 的工具,为发布新版本做准备。您可以在 GitHub 上的 OpenAPI-Specification 存储库 上查看所有更改和活动。
我们对 OpenAPI 规范进行澄清并修复规范中大量歧义和未解决问题的最大贡献者是 Henry Andrews。非常感谢 Henry 为使我们的“小字”易于任何人阅读所做出的所有努力。
我们每周的技术开发者社区会议(太平洋时间星期四上午 9:00,欢迎所有人参加)出席率很高,充满了富有洞察力的辩论和讨论,并且那里的参与度——以及会议间的所有辛勤工作——继续推动我们朝着目标前进。
社区新闻
在本期新闻通讯中,我们宣布了我们的社区英雄功能,该功能提供了 OpenAPI 社区中宝贵成员的个人资料。在第一个功能中,我们采访了 Henry Andrews,他是 OpenAPI 和 JSON Schema 的主题专家,也是社区的积极贡献者。您可以在我们的博客上阅读更多内容。
我们还可以向您发布我们首个 OpenAPI Initiative 培训课程 OpenAPI 基础知识即将发布的消息。本课程提供 OpenAPI 的基础知识,包括语言的历史和创建和使用 OpenAPI 描述的实际示例。此免费课程将于 2024 年 6 月 11 日起在 Linux 基金会 培训和认证 平台上提供。
活动综述
北半球的夏季即将到来,因此,会议日程往往会暂停。然而,自从我们上次发布新闻通讯以来,我们一直在各种会议上忙碌地运行我们的 OAI 轨道。OAI 轨道旨在汇聚社区领导者和从业人员,提供一系列专注且详细的关于 OpenAPI Initiative 规范各个方面的主题演讲。这些轨道由 Erik Wilde 协调,他将它们描述为
“OAI 轨道将 API 社区聚集在 OpenAPI 和标准化周围。我们通常会进行关于核心规范主题的演示,我们讨论实践和工具,我们还会提供贡献,其中演示者分享 OpenAPI 和标准化如何帮助他们在 API 之旅中取得成功。加入任何 OAI 轨道,获取关于 OpenAPI 和其他 OAI 活动的最新新闻和高质量演示!”
OAI 轨道于 4 月和 5 月在新加坡、纽约和赫尔辛基举办了三场 apidays 会议,以及 4 月在德国美因茨举行的 JAX 会议。我们听取了优秀演讲者的发言,包括 Frank Kilcommins,他介绍了 Arazzo 的细节(包括 在 apidays 赫尔辛基揭晓名称)。Darrel Miller 在纽约探讨了针对“SDK 厌恶者”使用 API 的问题,而 Sohaib Tariq 在新加坡讨论了从一百万个 API 定义中吸取的经验教训。
我们将来将在会议上运行 OAI 轨道,包括 apidays 巴黎会议,我们计划在会上提供关于 OpenAPI 的广泛培训课程。我们将在今年下半年启动正式的“OAI 认证计划”,包括 apidays 巴黎会议现场培训课程和在线课程。敬请关注详细信息,并查看 OAI 活动日历 以获取完整即将举行的活动列表。
我们也希望听到你的声音!请在 Slack 上的 Outreach 频道上与我们联系,告知即将举行的活动、聚会或您想与 OpenAPI 社区分享的任何信息。我们还希望了解您在设计和实施 API 时使用 OpenAPI 的经验,并在我们的博客上与社区分享这些经验。
最后…
本期新闻通讯到此结束。如果您有任何新闻想与 OpenAPI 社区分享,请通过电子邮件与我们联系或 加入 Slack 上的 Outreach 频道。我们也欢迎您提出建议,说明我们如何改进本期新闻通讯或为您提供信息,帮助您充分利用 OpenAPI Initiative 发布的规范。