Postman
通过 API Builder 支持 API-first 开发。您可以使用 API Builder
直接在 Postman 中设计您的 API。然后,您的规范可以作为 API 项目的单一事实来源。
您可以将 API 开发和测试过程的各种组件连接到您的架构,例如集合、文档、测试、模拟和监视器。您可以在
Postman 中对 API 进行版本控制,并将元素连接到特定版本和发行版。您还可以将 Postman
中的 API 与远程 Git 存储库同步。
高级步骤
以下是创建和使用 API 时涉及的高级步骤:
- 创建 API - 在 Postman 中启动新的 API。
- 版本控制 API - 管理 API 的不同版本和版本,并连接远程 Git 存储库以同步您的更改。
- 定义 API - 通过编辑架构、验证架构和元素以及生成集合来定义 API 。
- 开发 API - 向您的 API 添加模拟服务器和文档。
- 生成服务器代码- 从您的 OpenAPI 3 规范生成服务器端样板代码,您可以运行和扩展这些代码以包含您的业务逻辑。
- 测试 API -将测试添加到您的 API,并使用 CI 集成来构建和自动化测试。
- 部署 API - 连接您的 API 部署服务以在 Postman 中获得更大的可见性。
- 观察 API - 添加监视器以观察您的 API。
- 管理和共享 API - 与其他团队成员共享您的 API、添加评论、查看更改日志并观察更改。
- 查看和分析 API - 使用报告查看有关您的团队如何使用、开发和改进 API 的统计数据。
导航 API 构建器
从 Postman 的左侧边栏中打开API 。您可以从此处打开和编辑任何现有 API,或者创建或导入新
API。选择父条目以打开 API 的概览页面,或选择下方的子条目以打开 API 版本页面。
API概述页面显示有关 API 的所有版本的高级信息,以及每个 API 版本的列表。概述页面包括创建
API 新版本的操作。
选择一个 API 版本以打开其 API 版本页面。版本页面包含一个概览选项卡,其中显示 API
版本的描述、该版本的每个版本的列表以及相关的文档、环境和模拟服务器。API 版本页面还有选项卡,您可以在其中定义
API 架构、查看文档、添加测试、查看部署和监控 API 。此页面还具有连接和使用外部 Git
存储库的控件。
还有一个带有多个图标的右侧边栏,具体取决于当前打开的页面。例如,在API 版本页面上,有用于查看注释、从您的架构生成样板服务器代码以及查看
API 的更改日志的图标。从更改日志中,您还可以查看和创建新版本。
|