Level 250 加入 OpenAPI Initiative！Level 250 是一家咨询机构，帮助大大小小的公司改进其围绕 SaaS、API 和开发者工具的产品策略：https://www.level250.com
Level 250 由 Emmanuel Paraskakis 领导，他在产品管理方面拥有 20 多年的丰富经验，曾在从初创企业到财富 500 强公司的各种组织任职。Paraskakis 曾担任全球两大最重要的 API 产品的产品管理副总裁：Apiary 与 API Blueprint（被 Oracle 收购）以及 SwaggerHub（以及 Swagger 开源工具集），后者使用 OpenAPI。
凭借如此丰富的 API 和产品背景，我们询问了 Paraskakis 关于 Level 250、实施新的 OpenAPI 规范 3.1.0 以及 API 的未来发展方向。我们了解到 API 构建者和 API 消费者需求的融合，关于有助于管理规模的重大改进，帮助非人类（是的）等等！
— 为什么 Level 250 加入 OpenAPI Initiative 以及为什么现在？
我一直参与 OpenAPI，之前在两家成员公司 Apiary 和 SmartBear 工作过，所以它是我背景的一部分。API 和 OpenAPI 是 Level 250 所有工作的核心，所以我希望尽我所能继续支持 OpenAPI。
今天这件事变得更加相关的原因是，OpenAPI 正在变得远不止一个规范：它是围绕 API 进行思考和协作的地方，无论它是关于最初的 OpenAPI 规范，还是像 JSON Schema 和 AsyncAPI 这样的相邻规范，以及其他方面。我认为 OAI 正在成为 API 构建者和 API 消费者需求融合的焦点。令人兴奋的时刻！
— 实施 OpenAPI 规范的最大问题是什么？
我认为该规范是一种很棒的交换格式，一种大多数 API 工具都使用的通用语言，因此，例如，您可以将原本用于设计的文档重复使用以配置您的 API 管理或安全测试。
但是，由于它变得复杂，涵盖了许多用例，我认为它难以学习，我还认为它难以编写，例如对于设计优先的用例。有些工具可以简化此过程，提供语法建议甚至 UI 编辑器，但底层复杂性仍然存在。
我很想看到一种更简单的语言，可以在构思和设计过程中手写，也许利用示例，然后直接转换为当前规范以实现互操作性。
除此之外，我认为我们可以更多地努力使模块化和组合更容易，以及处理 API 网关的元数据、发现和运行时配置。
— 谁应该使用 OpenAPI 规范 3.1.0？
我认为最激动人心的消息是完全兼容 JSON Schema 并支持最新的 2020-12 草案！这使任何人都可以更详细地描述数据结构并增强与外部工具的兼容性。
另一个巨大的胜利将是那些需要描述 Webhook 的人，他们已经要求这样做有一段时间了。
一个似乎没有得到太多讨论的变化是，您_不需要_具有顶层 `paths` 元素，您只需要描述 `components`，这仍然是一个有效的 OpenAPI 文档。这对于重用来说是巨大的进步。因此，任何拥有大量 OpenAPI 文档并正在经历重复信息带来的痛苦，以及由此带来的所有问题的人，都应该升级到 3.1。
— 您对未来 1-3 年的 API 堆栈有什么展望？
如今，API 提供者遇到的主要问题是管理规模和缩短上市时间，因此我认为规范和各种描述格式通过充当我们服务工作方式的真相来源，在其中发挥着巨大的作用。我希望看到利用声明性文档来通知整个 API 构建生命周期的工具，从构思和设计到构建测试、在多个环境中创建部署以及设置监控/分析工具 - 所有这些都基于同一个真相来源！
在 API 消费者方面，我们仍然将开发人员引导到质量和完整性可能会有所不同的文档中。人类非常擅长处理模棱两可的事物，希望他们在遇到支持问题时会伸出援助之手。但越来越多的服务是由机器消费和发现的，因此我希望看到有助于非人类发现和理解 API 功能的工具。
OpenAPI 资源
要了解有关参与 OpenAPI 规范演进的更多信息，请访问：https://www.openapis.org.cn/participate/how-to-contribute
关于 OpenAPI Initiative
OpenAPI Initiative (OAI) 由一群有远见的行业专家创建，他们认识到标准化 API 描述方式的巨大价值。作为 Linux 基金会下的一个开放治理结构，OAI 致力于创建、发展和推广一种供应商中立的描述格式。OpenAPI 规范最初基于 Swagger 规范，由 SmartBear Software 捐赠。要参与 OpenAPI Initiative，请访问 https://www.openapis.org.cn
关于 Linux 基金会
Linux 基金会成立于 2000 年，拥有 1000 多个成员的支持，是全球领先的开源软件、开放标准、开放数据和开放硬件协作中心。Linux 基金会的项目，如 Linux、Kubernetes、Node.js 等等，被认为对世界上最重要的基础设施的发展至关重要。其开发方法利用了已建立的最佳实践，并满足了贡献者、用户和解决方案提供商的需求，以创建可持续的开放协作模式。有关更多信息，请访问 linuxfoundation.org。