Postman
可以导入和导出 Postman 数据,包括集合、环境、数据转储和全局变量。Postman 还可以以
API 模式的形式导入非 Postman 数据,以帮助您整合 API 开发工作流程。
内容
- 导入 Postman 数据
- 将 Postman 集合从 v1 转换为 v2
- 导入 API 规范
- 通过 GitHub 存储库导入
下一步
将数据导入 Postman
您可以将集合或 API 规范直接导入 Postman。
要将数据导入 Postman,请选择左上角的Import :
您可以从文件、文件夹、链接、原始文本或代码存储库中导入数据。
导入 Postman 数据
您可以导入之前导出的 Postman 数据,包括集合、环境、数据转储和全局变量。
1 在左侧导航菜单中选择导入。
2 选择您的文件或文件夹,输入您的链接,粘贴您的原始文本,或从 GitHub 导入。Postman
将自动识别 Postman 数据,确认名称、格式以及文件将导入的内容。
3 选择要导入的文件。
4 选择导入以将您的数据导入 Postman。
将 Postman 集合从 v1 转换为 v2
Postman 不再支持集合 v1 格式,如果您尝试导入此格式的集合,则会返回错误。
1 您可以将收藏的格式从 v1 转换为 v2 以将其导入 Postman:
2 在您选择的终端中,输入以下命令以安装 Postman Collection Transformer。
sudo npm install -g postman-collection-transformer
|
通过输入以下命令将单个 Postman 集合从 v1 转换为 v2。
postman-collection-transformer convert -i <path to the input Postman collection file> -o <path to the downloaded Postman file> -j 1.0.0 -p 2.0.0 -P
|
生成的集合将以 v2 格式下载到您的目标文件路径。
您可以通过运行带有-h标志的命令来检索转换选项列表:
postman-collection-transformer convert -h
|
有关集合转换的更多信息,请参阅Postman Collection
Transformer。
导入 API 规范
Postman 直接支持导入以下格式:
- OpenAPI 3.0 和 3.1
- 招摇1.2和2.0
- GraphQL
- 卷曲
- RAML 0.8和1.0
- WSDL 1.1 和 2.0
- HTTP 存档 (HAR)
- Web 应用程序描述语言 (WADL)
GitHub 上也有工具可以将不同的规范转换成 Postman 集合进行导入:
- runscope-to-postman
- DHC-to-postman
要将您的 API 规范导入 Postman:
1 在左侧导航菜单中选择导入。
2 选择文件或文件夹,输入 API 链接,或粘贴原始文本。确认名称、格式以及您希望数据导入的内容。
3 选择导入以将您的数据导入 Postman。
您可以配置Import Settings,这将根据您的 API 规范而有所不同。
您可以一次导入多个 API 规范文件。选择要将 API 导入到的工作区,选择是否要从 API
生成集合,配置详细信息,然后选择Import。
导入团队工作区时,您还可以选择将 API 添加到Private API Network。
通过 GitHub 存储库导入
您必须登录Postman 帐户才能使用此功能。
您可以从 GitHub 存储库批量导入数据。
1 选择导入>代码存储库> GitHub。
2 确认您的 GitHub 帐户并授权 postmanlabs访问您的存储库。
3 在 Postman 中,选择您的 GitHub 组织、存储库和分支,然后选择Continue。
4 确认您要导入 Postman 的文件。您还可以选择从导入的 API 生成集合,然后选择您希望将此集合链接为的内容。选择Show
advanced settings以控制 Postman 如何根据您的文件类型生成集合,然后选择Import。
导入完成后,您将收到确认。您现在可以在 Postman 中查看新导入的文件和生成的集合。
通过 Bitbucket 存储库导入
您必须登录Postman 帐户才能使用此功能。
1 您可以从 Bitbucket 存储库中批量导入数据。
2 选择导入>代码存储库> Bitbucket。
3 确认您的 Bitbucket 帐户并授权 Postman访问您的存储库。
4 在 Postman 中,选择您的 Bitbucket 工作区、存储库和分支,然后选择Continue。
Postman 显示要导入工作区的文件的预览。选择导入以确认并完成导入。
导入完成后,您将收到确认。您现在可以在 Postman 中查看新导入的文件和生成的集合。
导出 Postman 数据
您可以将 Postman 数据(包括集合、环境、数据转储和全局变量)导出为 JSON 文件。您可以将这些文件导入回任何
Postman 实例,或将它们与Postman 的命令行收集运行器Newman一起使用。
导出集合
1 选择三个点图标集合旁边的,然后选择导出。
2 选择您希望将收藏导出为的格式。
了解有关 Postman收集格式的更多信息。
3 选择导出以下载新生成的 JSON 文件。
导出环境
您还可以从 Postman 导出环境。
1 从左侧导航菜单中选择环境选项卡。
2 选择要导出的环境。
3 在右上角,选择三个点图标。
4 选择导出以下载新生成的 JSON 文件。
导出数据转储
您可以在 Postman 中导出所有集合、环境、全局变量和标题预设的数据转储。
1 选择右上角的齿轮图标以打开设置。
2 选择数据选项卡,然后选择导出数据以开始请求数据转储。
3 选择导出数据以确认您需要导出的数据类型。
4 选择请求数据导出以提交请求。
导出页面显示有关您的导出请求的信息,包括文件大小、导出到期日期以及您请求的数据导出的状态。可能的状态是:
- Scheduled:已发出导出请求。
- Transferring : 数据传输过程已经开始。
- Transferred:数据传输过程已完成。
- Zipping:压缩文件的过程已经开始。
- 压缩:文件被压缩。
- 下载:压缩文件已准备好下载。
导出准备好后,您将收到一封电子邮件,其中包含下载带有数据转储的压缩文件的链接。您还可以使用“导出”页面上的“下载”按钮下载文件。
从 Scratch Pad 导出的数据直接下载,而不是通过电子邮件发送给您。有关详细信息,请参阅从便笺簿中导出数据。
下一步
您可以通过分享和评论来与团队成员讨论您的 API 项目,从而在集合上进行协作。了解有关Postman
的 API 工作流程的更多信息。
|