API 开发概述

Postman 通过 API Builder 支持 API-first 开发。您可以使用 API Builder 直接在 Postman 中设计您的 API。然后,您的规范可以作为 API 项目的单一事实来源。

您可以将 API 开发和测试过程的各种组件连接到您的架构,例如集合、文档、测试、模拟和监视器。您可以在 Postman 中对 API 进行版本控制,并将元素连接到特定版本和发行版。您还可以将 Postman 中的 API 与远程 Git 存储库同步。

高级步骤

以下是创建和使用 API 时涉及的高级步骤:

从 Postman 的左侧边栏中打开API 。您可以从此处打开和编辑任何现有 API,或者创建或导入新 API。选择父条目以打开 API 的概览页面,或选择下方的子条目以打开API 版本页面。

API Builder 左侧边栏

API概述页面显示有关 API 的所有版本的高级信息,以及每个 API 版本的列表。概述页面包括创建 API 新版本的操作

API Builder 概览页面

选择一个 API 版本以打开其API 版本页面。版本页面包含一个概览选项卡,其中显示 API 版本的描述、该版本的每个版本的列表以及相关的文档、环境和模拟服务器。API 版本页面还有选项卡,您可以在其中定义 API 架构、查看文档、添加测试、查看部署和监控 API 。此页面还具有连接和使用外部 Git 存储库的控件。

API Builder 版本页面

还有一个带有多个图标的右侧边栏,具体取决于当前打开的页面。例如,在API 版本页面上,有用于查看注释、从您的架构生成样板服务器代码以及查看 API 的更改日志的图标。从更改日志中,您还可以查看和创建新版本。

API Builder 版本页面