SmartBear 的首席 API 布道师兼工作流 SIG 团队成员 Frank Kilcommins 将 Arazzo 描述为
“迈向提高整个行业 API 成熟度的重要里程碑。通过为基于价值的 API 使用提供确定性方案，Arazzo 规范通过其人类和机器可读属性充当活生生的 API 文档，减少了对带外入门指南的依赖。它确保了 API 提供商和整个 API 生命周期的监管利益相关者的可断言特性，同时也使工具供应商能够打造下一波 SDK 和代码生成器。
Arazzo 规范使人类 API 消费者能够更好地理解如何使用和组合 API，专注于他们的工作目标，从而减少他们的集成平均时间。同时，它为新一代 AI 消费者提供了一种一致且互操作的机制，以第一次以及每次都实现预期的 API 结果。”
**🌖 语义学提供目的**。仅仅描述 API 的机制而不描述其语义是不够的，无论消费者是人类还是 AI。语义学将是什么（…这是做什么的？）和为什么（…这有什么关系？）与如何（…这是如何运作的？）联系起来。
OpenAPI 已帮助人们更快地构建更好的 API，并且工具生态系统年复一年地提供更多价值。2023 年的新事物是一种新型的 API 消费者——生成式 AI。LLM 可以处理 OpenAPI 描述，然后使用该 API 来解决问题。凭借生成式 AI 理解自然语言的能力，OpenAPI 可以帮助非开发人员以从未有过的易用性访问 API 的强大功能。为了充分发挥这种潜力，API 生产者应在其 HTTP 请求的机械描述中添加传达这些 API 操作的含义和目的的详细信息。反过来，这有助于人和 LLM 都获得更好的结果。
换句话说，几个世纪以来，人们一直使用模糊的自然语言相互交流，几十年来我们一直使用硬核的编程语言与机器交流。LLM 架起了模糊和硬核世界之间的桥梁，这意味着以前无法使用 API 的大量人员现在可以使用 API 了。
无论您对生成式 AI 的看法如何，从炒作过头到改变世界，我们都可以预期许多人将使用 OpenAPI 来驱动基于 AI 的 API 消费者。如果 OpenAPI 没有采取措施满足该社区的需求，他们将找到替代方案。
任何 HTTP API 始终都是为了达到某种目的。API 消费者更喜欢重用现有功能，理想情况下，他们可以使用最自然的术语来了解该功能。PUT/PATCH/DELETE 返回 200 或 204 是一个实现细节，与它为客户端执行的功能相比相形见绌。如今，在 OpenAPI 中表达 API 函数签名的方式有限。pathItem 无法使用查询参数来区分操作。每个 HTTP 方法只能有一个操作。由于缺乏对唯一签名的正式定义，这些都是对 API 函数签名的人为限制。过去 OpenAPI 的工作重点是使开发人员能够描述 HTTP API。这重新确定了它们的优先级，以便开发人员可以使用 OpenAPI 定义具有唯一签名的 API 函数，然后将每个签名映射到 HTTP 机制。
**🌕 包容性需要一个大帐篷**：月球漫步旨在描述所有基于 HTTP 的 API。虽然它在 HTTP API 的设计方面保持中立，但它认识到拥有不同设计风格和观点的重要性。
月球漫步应该能够描述开发人员可能已经拥有的 HTTP API，以及设计他们可能想要构建的 API。它应该能够准确地将 API 函数的签名映射到 API 提供的 HTTP 请求和响应的实际实例。月球漫步确实更喜欢面向资源的 API 样式，因为它们非常流行，但应该能够描述纯 RPC API，即使这些 API 签名是通过 HTTP 标头值或请求正文值来区分的。
**🌗 通过关注点分离进行组织**。例如，API 的变化形状应该独立于 API 部署而移动。API 部署可以使用不同的安全方案进行保护。API 函数的签名不应与内容模式格式紧密耦合。
为了支持具有不同需求的不断增长的客户群，功能数量无疑会增加，从而带来更多复杂性。为了抵消这一点，我们将对 API 描述的不同方面的模块化应用更多严格性。我们将努力消除目前存在的歧义，并利用现有标准来最大程度地减少不必要的创新。我们的目标是为 API 描述消费者、作者和工具提供商提供更好的体验。
OpenAPI Initiative (OAI) 由一群具有前瞻性的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下属的一个开放治理结构，OAI 专注于创建、发展和推广一种与供应商无关的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn
关于 Linux 基金会
Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux、Kubernetes、Node.js 等 Linux 基金会项目被认为对世界最重要的基础设施的开发至关重要。其开发方法利用既定的最佳实践，并满足贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。
WireMock Inc. 正在构建软件，通过启用协作式 API 设计、模拟 API 和消除外部依赖项导致的减速来提高开发人员的生产力。该公司于 2022 年由 Tom Akehurst 和 Uri Maoz 成立，分别担任首席执行官和首席技术官。WireMock Cloud 是该公司旗舰产品，建立在该公司管理的 WireMock 开源项目之上。
OpenAPI Initiative (OAI) 由一群具有前瞻性的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下的开放治理结构，OAI 专注于创建、发展和推广供应商中立的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn
关于 Linux 基金会
Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux、Kubernetes、Node.js 等 Linux 基金会项目被认为对世界最重要的基础设施的开发至关重要。其开发方法利用既定的最佳实践，并满足贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。
OpenAPI Initiative (OAI) 由一群具有前瞻性的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下的开放治理结构，OAI 专注于创建、发展和推广供应商中立的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn
关于 Linux 基金会
Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux、Kubernetes、Node.js 等 Linux 基金会项目被认为对世界最重要的基础设施的开发至关重要。其开发方法利用既定的最佳实践，并满足贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。
欢迎来到 APIAddicts！APIAddicts 拥有最大的 API 从业人员社区之一，在包括西班牙、秘鲁和墨西哥在内的西班牙语国家拥有广泛的国际影响力，全球拥有 5,000 多名 APIAddicts，以及超过一百万次可视化。
APIAddicts 每年举办多次活动，供希望讨论、了解更多信息并为 API 的发展和集成做出贡献的开发人员参加。下面提供了许多详细信息。APIAddicts Days 是他们每年举办的最重要活动之一。公司和专业人士分享他们的经验，同时分析支持 API 的当前框架中的成功和失败。要了解 2020 年 APIAddicts Days 的情况，请点击 此处。
APIAddicts 非常重视教育。他们的 API 学校旨在帮助专业人士改进其 API 使用。课程结束后，您将获得 API 布道师证书/认可/文凭。
我们希望了解更多关于他们即将举行的活动和 API 领域的最新更新，以及与 OpenAPI Initiative 合作的情况。我们与 Marco Antonio Sanz（APIAddicts 的创始人）进行了交谈，以了解更多信息！
APIAddicts 是如何诞生的？
2013 年，五位非常懂技术的友人和同事在大型公司管理 API，并意识到当时缺乏西班牙语的 API 文档和教育。
这在不断发展，最终形成了今天的 APIAddicts，这是西班牙语地区最大的 API 社区，在西班牙、智利、秘鲁、墨西哥、哥伦比亚和阿根廷拥有 5000 多名 APIAddicts。
获得 API 布道师文凭有多难？主要好处是什么？
API 的推广和专业人士的培训非常重要，因此，基金会希望更进一步，帮助公司为其团队提供最新的知识和来自最佳专家的知识。
我们已经开展了多年的 API 所有者课程，该课程如今非常受欢迎，我们决定通过安全、测试、设计和架构专业课程来完善培训。这样，您可以全面了解公司的整个 API 化流程，并学习如何优化地管理每个阶段。
所有课程总共包含 50 小时的培训，其中 80% 为实践操作，学生可以在其中应用他们学到的知识。课程结束后，他们向老师展示一个 API 项目，老师会评估和评估文档。
如果他们在考虑到课程要求和概念的情况下完成了 API 项目，他们将获得每个专业的证书和 API 布道师文凭，这是 API 专业人员的最高认证。
如今，许多公司都信任基金会的 API 学校课程，并通过这些课程为其团队（项目经理、质量保证、技术主管、分析师、协调员等）提供专业培训。参加这些课程可以保证您了解整个 API 化流程并明确管理必要的工具。这不仅提高了您的工作前景，也提高了您在公司内部的职业发展。
APIAddicts 在 API 推广中的使命是什么？
我们一直意识到，尽管 API 是当今希望保持竞争力的公司的关键因素，但它是一个容易引起很多混淆的术语。因此，可以说 APIAddicts 基金会的推广使命始于 2013 年，当时 API 已经在使用，但没有人完全理解它们的作用。事实上，我们社区的作用对于在西班牙普及 API 的变革潜力至关重要。
从这个意义上说，我们每年进行研究、开源工具、培训课程、3 个大型活动：网络系列、初创企业和 API 以及 APIAddicts Days，以及 20 多次年度聚会。我们是创建了更多西班牙语 API 文档的社区，现在我们希望继续与 OpenAPI 合作。
我们认为，如果我们必须定义我们的主要差异化因素，那就是我们始终努力让行业中最好的参考人物来启发 API 的使用，并且始终以一种亲密的互动方式进行，成为一个真正的社区。这就是为什么，例如，我们所有的 API 学校课程都没有录制，因为对我们来说，这会让您失去 API 培训的重要组成部分：与现场专家分享经验和真实案例。
最后，我们每天都在越来越努力地继续我们创立的初衷：以颠覆性的方式将 API 的知识带到世界上的每一个西班牙语角落。
APIAddicts 和 CloudAPPI 之间的关系是什么？
在通过演讲和聚会开始 API 推广后，社区越来越受欢迎，随之而来的是商业机会。这成为一个转折点，他们决定离开他们通常的工作，成立自己的咨询公司，在协会的基础之外，因为一方面是基金会，另一方面是公司，但他们可以作为合作伙伴相互支持发展，两者都从不同的角度处理 API 的生命周期。
OpenAPI Initiative (OAI) 由一群具有前瞻性的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下的开放治理结构，OAI 专注于创建、发展和推广供应商中立的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn
关于 Linux 基金会
Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux、Kubernetes、Node.js 等 Linux 基金会项目被认为对世界最重要的基础设施的开发至关重要。其开发方法利用既定的最佳实践，并满足贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。
为了更好地理解 RapidAPI 如何为 API 提供下一代基础设施，以及与 OpenAPI Initiative 的合作对他们意味着什么，我们采访了首席执行官兼创始人 Iddo Gino。
RapidAPI 为什么加入 OpenAPI Initiative，以及为什么选择现在？
API 是 RapidAPI 的核心。通过收购诸如 Paw 客户端 和独特的开发者工具（如 RapidAPI 测试）等，我们非常重视编写、发布并最终维护 API 的开发者体验。OpenAPI 在所有这些方面都发挥着重要作用。
我们加入 OpenAPI Initiative 的目标是回馈社区。随着我们构建 下一代 API 开发者工具，成为 API 构建者社区对话的一部分比以往任何时候都更加重要。OAI 是 API 构建者和 API 消费者超越原始规范，在 JSON Schema 和异步 API 等令人兴奋的事情上进行协作的地方。RapidAPI 希望通过参与社区来帮助推进规范。
OpenAPI Initiative (OAI) 由一群具有前瞻性的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下属的一个开放治理结构，OAI 专注于创建、发展和推广一种供应商中立的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn
关于 Linux 基金会
Linux 基金会成立于 2000 年，拥有 1000 多名成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux、Kubernetes、Node.js 等 Linux 基金会项目被认为对世界最重要的基础设施的开发至关重要。其开发方法利用既定的最佳实践，并满足贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。
OpenAPI 规范的下一步是什么？v4 将如何改进 OpenAPI v3 的成功？规范如何在 AI 和 LLM 的背景下帮助解决问题？
