Question

数据格式

Postman 可以导入或导出集合，环境，全局变量和 header 预设为文件和链接。

---

导入和导出 Postman 数据

Postman 可以导入和导出以下格式作为文件或生成的 URL。从 Postman 应用程序导出集合时，导出的文件是一个 JSON 文件。该文件包含 Postman 在导入 Postman 时重新创建集合所需的所有数据（和元数据），或由 Newman 从命令行界面（CLI）运行集合所使用的所有数据（和元数据）。

集合

导出集合

Postman 可以导出两种格式的集合 - v1 和 v2。Collection v1 和 v2 都作为 JSON 文件下载; v2 是更多功能和最常用的选择。了解有关 v1 和 v2 格式的 更多信息。

选择 v1 或 v2 格式

环境

环境可以从 MANAGE ENVIRONMENTS 窗口导出，同样也在这里导入。

导出环境

数据转储

导出所有 Postman 数据

从 SETTINGS 窗口的 数据 （ Data ） 选项卡 ，Postman 允许您将所有集合，环境，全局变量和 header 预设导出到一个 JSON 文件中。Postman 不会导出你的历史记录。您可以将此数据导入 Postman。

导入 Postman 数据

可以从 SETTINGS 窗口的 数据 （ Data ） 选项卡中 导入 Postman 数据，也可以 使用 标题工具栏中的 导入 （ Import ）按钮。使用 IMPORT 窗口导入集合，环境，数据转储，curl 命令或 RAML / WADL / Swagger（v1 / v2）/ Runscope 文件 。

导入数据

---

导入 cURL

最有效的 cURL（仅 HTTP）命令可以导入 Postman。Postman 的导入功能支持以下 cURL 选项：

选项	描述
-A, –user-agent	可选的用户代理字符串
-d, –data	将指定的数据发送到具有 application / x-www-form-urlencoded 类型的服务器
–data-ascii	将指定的数据发送到具有 application / x-www-form-urlencoded 类型的服务器
–data-urlencode	将指定的数据发送到具有 application / x-www-form-urlencoded 类型的服务器
–data-binary	数据按原样发送
-F，-form <name = content>	单个表单数据字段（可以多次使用）
-G, –get	强制发送请求为 GET，附加到查询字符串的-data 参数
-H, –header	添加 header（可多次使用）
-X, –request	指定要使用的自定义请求方法
–url	指定 URL 的另一种方法

可以导入的几个命令包括：

cURL	效果
curl http://postman-echo.com/get	在 Postman 中创建一个 GET 请求，并预先填充 URL
curl –request POST –url http://postman-echo.com/post –form color=red –form color=green	使用多值表单数据行创建 POST 请求
curl -X PUT –data-binary hello http://postman-echo.com/put	使用原始数据创建 POST 请求
curl -X PUT –data-ascii ‘a=b&c=d’ http://postman-echo.com/put -H ‘AccessToken:1234’	使用 urlencoded 表单数据和自定义标头创建 PUT 请求

---

导入 RAML

将 RAML 文件夹保存为集合

1. 将包含 RAML 定义的存储库克隆到本地计算机，或将其本地保存为文件夹。
2. 单击导入（Import）按钮，然后选择导入文件夹（Import Folder）选项卡。 导入按钮
3. 单击 选择文件夹 （ Choose Folders ）并上传 RAML 文件夹。 导入文件夹窗口

恭喜你完成了！Postman 将检测所有 RAML 定义，并将其内部转换为 Postman，然后向您显示导入成功 d 的消息。

确认消息

示例

下载一个 RAML 示例文件： github-api-v3.raml

---

导入 Swagger

Swagger API 定义通常以单个文件的形式存在，因此我们只支持导入单个 swagger 文件。如果文件夹中有很多不相关的 Swagger 文件，则可以通过文件夹导入器导入这些文件。

将 Swagger 文件另存为集合

1. 将包含 Swagger 定义的存储库克隆到本地计算机。如果你已经把它保存在本地的文件中，那当然可以。

2. 单击导入（ Import）按钮，然后选择导入文件（ Import File）选项卡。如果文件夹中有很多不相关的 Swagger 文件，则可以通过文件夹导入器导入这些文件。

   导入按钮
3. 点击文件并上传 Swagger 文件。

恭喜你完成了！Postman 将检测所有 Swagger 定义并将其内部转换为 Postman，然后向您显示导入成功消息。

确认消息

示例

Swagger 2.0： https ： //github.com/OAI/OpenAPI-Specification/tree/master/examples/v2.0

Swagger 1.2： https ： //github.com/OAI/OpenAPI-Specification/wiki/Hello-World-Sample

---

导入 WADL

Postman 也可以导入 W​​ADL 规范。虽然所有方面都不受支持，但您可以期待 Postman 使用的各种参数（集合，文件夹，请求，标头，请求有效载荷）的正确生成。我们正在努力扩展此功能。

示例 WADL 文件

<application xmlns="http://wadl.dev.java.net/2009/02">
  <resources base="http://example.com/api">
    <resource path="books">
      <method name="GET"/>
      <resource path="{bookId}">
        <param required="true" name="bookId"/>
        <method name="GET"/>
        <method name="DELETE"/>
        <resource path="reviews">
          <method name="GET">
            <request>
              <param name="page" required="false" default="1"/>
              <param name="size" required="false" default="20"/>
            </request>
          </method>
        </resource>
      </resource>
    </resource>
    <resource path="readers">
      <method name="GET"/>
    </resource>
  </resources>
</application>

取自 http://www.nurkiewicz.com/2012/01/gentle-introduction-to-wadl-in-java.html

---

验证集合 JSON 文件

要验证 JSON 文件是否采用正确的集合格式，可以使用我们的 文件集合模式 。

• 模式文件位于 http://schema.getpostman.com/json/collection/v1.0.0/collection.json 。
• 相关文档可以在 http://schema.getpostman.com/json/collection/v1.0.0/docs/index.html 找到 。
• 一切都整齐地存储在 GitHub https://github.com/postmanlabs/schemas 上 。
• 要查看使用我们的模式和 is-my-json-valid （验证器）的数据验证示例 ，请查看 此博客文章 。