跳至主要内容

Postman 加入 OAI 支持 OpenAPI 规范

作者: 2020 年 7 月 23 日公告, 博客

这篇博文由 Postman 首席布道师 Kin Lane 撰写

当 Postman 去年推出其 API 构建器时,我们惊讶地发现,在设计和开发 API 方面,OpenAPI 在我们的用户中非常流行。我们的使用统计数据帮助我们意识到 OpenAPI 规范对于客户如何设计和构建 API 的重要性。如今,Postman 加入 OpenAPI Initiative,与其他 35 个 OAI 成员共同推动规范发展。我们将共同努力,继续支持建立在该规范基础上的开源工具,并发展更强大的 OpenAPI 社区,以确保这一重要行业标准的未来。 

历史上,Postman 集合是 API 提供者在平台上定义 API 的方式。随着 API 构建器的推出,越来越多的 API 提供者开始使用 OpenAPI 作为开发的每个 API 的核心定义。多年来,Postman 集合不断发展,允许开发人员测试、模拟、记录和自动化 API 生命周期的各个部分。随着这种发展,每个集合都可以从 OpenAPI 生成,促使我们交付越来越多的特定功能,以帮助客户将 OpenAPI 作为 API 合约用于他们的所有 API 操作

  • 导入 - 您可以在 Postman 中导入 OpenAPI 文档,并将其作为每个单独 API 的核心合约进行维护,用于验证并通知开发人员何时文档、集合或测试与 OpenAPI 合约不一致。
  • 生成 - 您可以在 OpenAPI 定义的基础上生成 Postman 集合,为您的 API 合约建立衍生品,以便在不同地区持续用于记录、模拟和测试您的 API。
  • 验证 - 从 OpenAPI 规范生成的每个集合都可以在 OpenAPI 合约中进行验证,有助于保持文档、模拟服务器和测试基础设施在整个操作过程中的同步。
  • GitHub 同步 - 当您使用 API 构建器在 Postman 中管理 OpenAPI 文档时,您可以将其同步到 GitHub,使其能够在其他系统中使用,允许在 Postman 或其他工具中进行更改。

OpenAPI 已成为 Postman 客户 API 工厂车间的组成部分。除了规范的描述之外,Postman 通过允许您存储多个配置文件或生命周期阶段的令牌或密钥,以及为运行测试或监控添加特定值,使 API 操作更加轻松。OpenAPI 规范提供了一种定义 HTTP API 可能性的方法,而 Postman 集合则作为一种方法出现,用于定义、执行和自动化 API 生命周期中的每个步骤。OpenAPI 和 Postman 之间更牢固的关系帮助了我们的客户,我们很高兴能够加入关于 OpenAPI 路线图的讨论,并帮助实现跨 API 生命周期使用 OpenAPI 的全部优势。