导入和导出数据

Postman 可以导入和导出 Postman 数据，包括集合、环境、数据转储和全局变量。Postman 还可以以 API 模式的形式导入非 Postman 数据，以帮助您整合 API 开发工作流程。

内容

• 将数据导入 Postman

  • 导入 Postman 数据

  • 将 Postman 集合从 v1 转换为 v2

  • 导入 API 规范

  • 通过 GitHub 存储库导入

• 导出 Postman 数据

  • 导出集合

  • 导出环境

  • 导出数据转储

• 下一步

将数据导入 Postman

您可以将集合或 API 规范直接导入 Postman。

要将数据导入 Postman，请选择左上角的Import ：

您可以从文件、文件夹、链接、原始文本或代码存储库中导入数据。

导入 Postman 数据

您可以导入之前导出的 Postman 数据，包括集合、环境、数据转储和全局变量。

1. 在左侧导航菜单中选择导入。
2. 选择您的文件或文件夹，输入您的链接，粘贴您的原始文本，或从 GitHub 导入。Postman 将自动识别 Postman 数据，确认名称、格式以及文件将导入的内容。
3. 选择要导入的文件。
4. 选择导入以将您的数据导入 Postman。

将 Postman 集合从 v1 转换为 v2

Postman 不再支持集合 v1 格式，如果您尝试导入此格式的集合，则会返回错误。

您可以将收藏的格式从 v1 转换为 v2 以将其导入 Postman：

1. 在您选择的终端中，输入以下命令以安装 Postman Collection Transformer。

   sudo npm install -g postman-collection-transformer

2. 通过输入以下命令将单个 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 帐户才能使用此功能。

您可以从 Bitbucket 存储库中批量导入数据。

1. 选择导入>代码存储库> Bitbucket。

2. 确认您的 Bitbucket 帐户并授权 Postman访问您的存储库。

3. 在 Postman 中，选择您的 Bitbucket 工作区、存储库和分支，然后选择Continue。

4. 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 工作流程的更多信息。