欢迎来到 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 存储库 上查看所有更改和活动。
我们最大的贡献者是 Henry Andrews,他负责对 OpenAPI 规范进行澄清,并修复了规范中大量的歧义和未解决问题。非常感谢 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 发布的规范的信息。