导入和导出数据

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

你可以将集合、API 规范和数据文件直接导入 Postman。

要将数据导入 Postman，请选择左上角的导入。导入模式打开。

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

使用 cURL 命令导入

你可以使用 cURL 命令导入数据。

1. 在左侧导航菜单中选择导入。导入模式打开。

2. 将你的 cURL 命令粘贴到顶部的输入字段中。Postman 自动创建并打开一个请求。

   你还可以将 cURL 命令粘贴到请求的 URL 字段中。

导入 Postman 数据

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

1. 在左侧导航菜单中选择导入。

2. 执行以下操作之一：

   • 选择你的文件或文件夹，或将其拖到“导入”模式中。
   • 将原始文本或 URL 粘贴到输入字段中。
   • 选择一个按钮以从 GitHub 、 Bitbucket 或 GitLab 代码存储库导入。
   • 选择其他来源以导入 Azure 代码存储库，或 从 Amazon API Gateway 或 Azure API Management 导入 API 。

   Postman 将自动识别 Postman 数据，确认名称、格式以及文件将导入的内容。

3. 如果要导入多个文件，请选择要导入的文件并选择“导入”以将数据导入 Postman。

   如果你正在导入单个文件，Postman 会在你选择它时自动导入它。

将 Postman 集合从 v1 转换为 v2

Postman 不再支持集合 v1 格式，如果你导入此格式的集合，将返回错误。你可以将集合的格式从 v1 转换为 v2，以将其导入 Postman。

要将集合的格式从 v1 转换为 v2，请执行以下操作：

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 规范

要将 API 规范导入 Postman，请参阅 导入 API 。

从 GitHub 存储库导入

你可以从本地或远程存储库导入文件。

要从本地 GitHub 存储库导入：

1. 在 Postman 中，选择导入以打开导入模式。

2. 在你的计算机上，将文件夹或文件拖放到导入模式中。

3. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。

4. 如果要导入包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

   

要从远程 GitHub 存储库导入数据：

你必须登录 Postman 帐户 才能使用此功能。

1. 在 Postman 中，选择导入，然后选择GitHub按钮。
2. 确认或登录你的 GitHub 帐户并授权postmanlabs在必要时访问你的存储库。
3. 在 Postman 中，选择你的 GitHub 组织、存储库和分支，然后选择Continue。
4. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。
5. 如果要导入包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

从 Bitbucket 存储库导入

你可以从本地或远程存储库导入文件。

要从本地 Bitbucket 存储库导入：

1. 在 Postman 中，选择导入以打开导入模式。

2. 在你的计算机上，将文件夹或文件拖放到导入模式中。

3. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。

4. 如果要导入包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

   

从远程 Bitbucket 存储库导入数据：

你必须登录 Postman 帐户 才能使用此功能。

1. 在 Postman 中，选择导入，然后选择Bitbucket按钮。
2. 确认或登录你的 Bitbucket 帐户并授权postmanlabs在必要时访问你的存储库。
3. 在 Postman 中，选择你的 Bitbucket 工作空间、存储库和分支，然后选择Continue。
4. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。
5. 如果你的存储库具有包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

从 GitLab 存储库导入

你可以从本地或远程存储库导入文件。

从本地 GitLab 存储库导入：

1. 在 Postman 中，选择导入以打开导入模式。

2. 在你的计算机上，将文件夹或文件拖放到导入模式中。

3. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。

4. 如果要导入包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

   

从远程 GitLab 存储库导入数据：

你必须登录 Postman 帐户 才能使用此功能。

1. 在 Postman 中，选择导入，然后选择GitLab按钮。
2. 确认或登录你的 GitLab 帐户并授权postmanlabs在必要时访问你的存储库。
3. 在 Postman 中，选择你的 GitLab 组织、项目和分支，然后选择Continue。
4. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。
5. 如果你的存储库具有包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

从 Azure DevOps 存储库导入

你可以从本地或远程存储库导入文件。

从本地 Azure DevOps 存储库导入：

1. 在 Postman 中，选择导入以打开导入模式。

2. 在你的计算机上，将文件夹或文件拖放到导入模式中。

3. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。

4. 如果要导入包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

   

从远程 Azure DevOps 存储库导入数据：

你必须登录 Postman 帐户 才能使用此功能。

1. 在 Postman 中，选择“导入”>“其他来源”>“Azure”。
2. 确认或登录你的 Azure DevOps 帐户并授权postmanlabs在必要时访问你的存储库。
3. 在 Postman 中，选择你的 Azure DevOps 工作空间、存储库和分支，然后选择继续。
4. 选择将你的 API 作为Postman Collection或OpenAPI 3.0 with a Postman Collection导入。
5. 如果你的存储库具有包含多个文件的 API 定义，请选择要导入 Postman 的文件，然后选择导入。

导出 Postman 数据

你可以将 Postman 数据（包括集合、环境、数据转储和全局变量）导出为 JSON 文件。你可以将这些文件导入回任何 Postman 实例，或将它们与 Newman （Postman 的命令行 collection run 程序）一起使用。

导出集合

1. 选择集合旁边的更多操作图标 ，然后选择导出。

   

2. 选择你希望收藏导出的格式。

   了解有关 Postman 的 收藏格式 的更多信息。

3. 选择导出以下载新生成的 JSON 文件。

导出环境

你还可以从 Postman 导出你的环境。

1. 从边栏中选择环境。
2. 选择要导出的环境。
3. 在工作台中，选择更多操作图标 ，然后选择导出以下载新生成的 JSON 文件。

导出数据转储

你可以在 Postman 中导出所有集合、环境、全局变量和 header 预设的数据转储。

你可以从 Scratch Pad 导出单个集合和环境。你无法一次导出所有集合和环境的批量数据。

1. 选择标题中的设置图标 ，然后选择设置。

2. 选择“数据”选项卡，然后选择“导出数据”以启动你的数据转储请求。

3. 选择导出数据以确认你需要导出的数据类型。

4. 选择请求数据导出以提交请求。

   

导出 页面 显示有关你的导出请求的信息，包括文件大小、导出到期日期以及你请求的数据导出的状态。可能的状态是：

• 预定- 已发出导出请求。
• 正在传输- 数据传输过程已经开始。
• 已传输- 数据传输过程已完成。
• 压缩- 压缩文件的过程已经开始。
• 已压缩- 文件已压缩。
• 下载- 压缩文件已准备好下载。

导出准备就绪后，你将收到一封电子邮件，其中包含用于下载包含数据转储的压缩文件的链接。你还可以使用下载从导出页面下载文件。