Postman中文文档——数据格式

数据格式

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


导入和导出Postman数据

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

集合

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

环境

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

数据转储

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" style="template" name="bookId"/>
        <method name="GET"/>
        <method name="DELETE"/>
        <resource path="reviews">
          <method name="GET">
            <request>
              <param name="page" required="false" default="1" style="query"/>
              <param name="size" required="false" default="20" style="query"/>
            </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文件是否采用正确的集合格式,可以使用我们的文件集合模式

最后编辑于
©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 212,383评论 6 493
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 90,522评论 3 385
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 157,852评论 0 348
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 56,621评论 1 284
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 65,741评论 6 386
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 49,929评论 1 290
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 39,076评论 3 410
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 37,803评论 0 268
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 44,265评论 1 303
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 36,582评论 2 327
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 38,716评论 1 341
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 34,395评论 4 333
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 40,039评论 3 316
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 30,798评论 0 21
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 32,027评论 1 266
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 46,488评论 2 361
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 43,612评论 2 350

推荐阅读更多精彩内容

  • Spring Cloud为开发人员提供了快速构建分布式系统中一些常见模式的工具(例如配置管理,服务发现,断路器,智...
    卡卡罗2017阅读 134,637评论 18 139
  • Android 自定义View的各种姿势1 Activity的显示之ViewRootImpl详解 Activity...
    passiontim阅读 171,837评论 25 707
  • 02 你的收获 你如果耐心的看完这篇文章,你会获得些许收获 对postman的使用有一个基(全)本(面)认知 可以...
    亭子青年阅读 29,558评论 0 18
  • Postman提供了一个多窗口和多标签界面让您处理API。Postman努力保持清洁灵活的需求。它为您提供尽可能多...
    千夜阅读 51,178评论 6 20
  • 今天下午回来特别累 躺倒床上就睡着了 梦到前女友来找我 胖了很多还带了吃的 给了我一个胡子拉碴的吻 问我什么时候回上海
    blingbling就是我阅读 83评论 0 0