Postman中文文檔——數(shù)據(jù)格式

數(shù)據(jù)格式

Postman可以導(dǎo)入或?qū)С黾希h(huán)境,全局變量和header預(yù)設(shè)為文件和鏈接。


導(dǎo)入和導(dǎo)出Postman數(shù)據(jù)

Postman可以導(dǎo)入和導(dǎo)出以下格式作為文件或生成的URL。從Postman應(yīng)用程序?qū)С黾蠒r(shí),導(dǎo)出的文件是一個(gè)JSON文件。該文件包含Postman在導(dǎo)入Postman時(shí)重新創(chuàng)建集合所需的所有數(shù)據(jù)(和元數(shù)據(jù)),或由Newman從命令行界面(CLI)運(yùn)行集合所使用的所有數(shù)據(jù)(和元數(shù)據(jù))。

集合

Postman可以導(dǎo)出兩種格式的集合 —— v1和v2。Collection v1和v2都作為JSON文件下載; v2是更多功能和最常用的選擇。了解有關(guān)v1和v2格式的更多信息。

環(huán)境

環(huán)境可以從MANAGE ENVIRONMENTS窗口導(dǎo)出,同樣也在這里導(dǎo)入。

數(shù)據(jù)轉(zhuǎn)儲

SETTINGS 窗口的數(shù)據(jù)Data) 選項(xiàng)卡 ,Postman允許您將所有集合,環(huán)境,全局變量和header預(yù)設(shè)導(dǎo)出到一個(gè)JSON文件中。Postman不會導(dǎo)出你的歷史記錄。您可以將此數(shù)據(jù)導(dǎo)入Postman。

導(dǎo)入Postman數(shù)據(jù)

可以從SETTINGS 窗口的數(shù)據(jù)Data) 選項(xiàng)卡中 導(dǎo)入Postman數(shù)據(jù),也可以 使用 標(biāo)題工具欄中的 導(dǎo)入Import)按鈕。使用IMPORT 窗口導(dǎo)入集合,環(huán)境,數(shù)據(jù)轉(zhuǎn)儲,curl命令或RAML / WADL / Swagger(v1 / v2)/ Runscope文件 。


導(dǎo)入cURL

最有效的cURL(僅HTTP)命令可以導(dǎo)入Postman。Postman的導(dǎo)入功能支持以下cURL選項(xiàng):

選項(xiàng) 描述
-A, –user-agent 可選的用戶代理字符串
-d, –data 將指定的數(shù)據(jù)發(fā)送到具有application / x-www-form-urlencoded類型的服務(wù)器
–data-ascii 將指定的數(shù)據(jù)發(fā)送到具有application / x-www-form-urlencoded類型的服務(wù)器
–data-urlencode 將指定的數(shù)據(jù)發(fā)送到具有application / x-www-form-urlencoded類型的服務(wù)器
–data-binary 數(shù)據(jù)按原樣發(fā)送
-F,-form <name = content> 單個(gè)表單數(shù)據(jù)字段(可以多次使用)
-G, –get 強(qiáng)制發(fā)送請求為GET,附加到查詢字符串的-data參數(shù)
-H, –header 添加header(可多次使用)
-X, –request 指定要使用的自定義請求方法
–url 指定URL的另一種方法

可以導(dǎo)入的幾個(gè)命令包括:

cURL 效果
curl http://postman-echo.com/get 在Postman中創(chuàng)建一個(gè)GET請求,并預(yù)先填充URL
curl –request POST –url http://postman-echo.com/post –form color=red –form color=green 使用多值表單數(shù)據(jù)行創(chuàng)建POST請求
curl -X PUT –data-binary hello http://postman-echo.com/put 使用原始數(shù)據(jù)創(chuàng)建POST請求
curl -X PUT –data-ascii ‘a(chǎn)=b&c=d’ http://postman-echo.com/put -H ‘AccessToken:1234’ 使用urlencoded表單數(shù)據(jù)和自定義標(biāo)頭創(chuàng)建PUT請求

導(dǎo)入RAML

將RAML文件夾保存為集合
  1. 將包含RAML定義的存儲庫克隆到本地計(jì)算機(jī),或?qū)⑵浔镜乇4鏋槲募A。
  2. 單擊導(dǎo)入(Import)按鈕,然后選擇導(dǎo)入文件夾(Import Folder)選項(xiàng)卡。
    導(dǎo)入按鈕
  3. 單擊 選擇文件夾Choose Folders)并上傳RAML文件夾。
    導(dǎo)入文件夾窗口

恭喜你完成了!Postman將檢測所有RAML定義,并將其內(nèi)部轉(zhuǎn)換為Postman,然后向您顯示導(dǎo)入成功d的消息。

示例

下載一個(gè)RAML示例文件: github-api-v3.raml


導(dǎo)入Swagger

Swagger API定義通常以單個(gè)文件的形式存在,因此我們只支持導(dǎo)入單個(gè)swagger文件。如果文件夾中有很多不相關(guān)的Swagger文件,則可以通過文件夾導(dǎo)入器導(dǎo)入這些文件。

將Swagger文件另存為集合
  1. 將包含Swagger定義的存儲庫克隆到本地計(jì)算機(jī)。如果你已經(jīng)把它保存在本地的文件中,那當(dāng)然可以。

  2. 單擊導(dǎo)入( Import)按鈕,然后選擇導(dǎo)入文件( Import File)選項(xiàng)卡。如果文件夾中有很多不相關(guān)的Swagger文件,則可以通過文件夾導(dǎo)入器導(dǎo)入這些文件。

  3. 點(diǎn)擊文件并上傳Swagger文件。

恭喜你完成了!Postman將檢測所有Swagger定義并將其內(nèi)部轉(zhuǎn)換為Postman,然后向您顯示導(dǎo)入成功消息。

示例

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


導(dǎo)入WADL

Postman也可以導(dǎo)入W??ADL規(guī)范。雖然所有方面都不受支持,但您可以期待Postman使用的各種參數(shù)(集合,文件夾,請求,標(biāo)頭,請求有效載荷)的正確生成。我們正在努力擴(kuò)展此功能。

示例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


驗(yàn)證集合JSON文件

要驗(yàn)證JSON文件是否采用正確的集合格式,可以使用我們的文件集合模式

最后編輯于
?著作權(quán)歸作者所有,轉(zhuǎn)載或內(nèi)容合作請聯(lián)系作者
平臺聲明:文章內(nèi)容(如有圖片或視頻亦包括在內(nèi))由作者上傳并發(fā)布,文章內(nèi)容僅代表作者本人觀點(diǎn),簡書系信息發(fā)布平臺,僅提供信息存儲服務(wù)。
  • 序言:七十年代末,一起剝皮案震驚了整個(gè)濱河市,隨后出現(xiàn)的幾起案子,更是在濱河造成了極大的恐慌,老刑警劉巖,帶你破解...
    沈念sama閱讀 229,908評論 6 541
  • 序言:濱河連續(xù)發(fā)生了三起死亡事件,死亡現(xiàn)場離奇詭異,居然都是意外死亡,警方通過查閱死者的電腦和手機(jī),發(fā)現(xiàn)死者居然都...
    沈念sama閱讀 99,324評論 3 429
  • 文/潘曉璐 我一進(jìn)店門,熙熙樓的掌柜王于貴愁眉苦臉地迎上來,“玉大人,你說我怎么就攤上這事。” “怎么了?”我有些...
    開封第一講書人閱讀 178,018評論 0 383
  • 文/不壞的土叔 我叫張陵,是天一觀的道長。 經(jīng)常有香客問我,道長,這世上最難降的妖魔是什么? 我笑而不...
    開封第一講書人閱讀 63,675評論 1 317
  • 正文 為了忘掉前任,我火速辦了婚禮,結(jié)果婚禮上,老公的妹妹穿的比我還像新娘。我一直安慰自己,他們只是感情好,可當(dāng)我...
    茶點(diǎn)故事閱讀 72,417評論 6 412
  • 文/花漫 我一把揭開白布。 她就那樣靜靜地躺著,像睡著了一般。 火紅的嫁衣襯著肌膚如雪。 梳的紋絲不亂的頭發(fā)上,一...
    開封第一講書人閱讀 55,783評論 1 329
  • 那天,我揣著相機(jī)與錄音,去河邊找鬼。 笑死,一個(gè)胖子當(dāng)著我的面吹牛,可吹牛的內(nèi)容都是我干的。 我是一名探鬼主播,決...
    沈念sama閱讀 43,779評論 3 446
  • 文/蒼蘭香墨 我猛地睜開眼,長吁一口氣:“原來是場噩夢啊……” “哼!你這毒婦竟也來了?” 一聲冷哼從身側(cè)響起,我...
    開封第一講書人閱讀 42,960評論 0 290
  • 序言:老撾萬榮一對情侶失蹤,失蹤者是張志新(化名)和其女友劉穎,沒想到半個(gè)月后,有當(dāng)?shù)厝嗽跇淞掷锇l(fā)現(xiàn)了一具尸體,經(jīng)...
    沈念sama閱讀 49,522評論 1 335
  • 正文 獨(dú)居荒郊野嶺守林人離奇死亡,尸身上長有42處帶血的膿包…… 初始之章·張勛 以下內(nèi)容為張勛視角 年9月15日...
    茶點(diǎn)故事閱讀 41,267評論 3 358
  • 正文 我和宋清朗相戀三年,在試婚紗的時(shí)候發(fā)現(xiàn)自己被綠了。 大學(xué)時(shí)的朋友給我發(fā)了我未婚夫和他白月光在一起吃飯的照片。...
    茶點(diǎn)故事閱讀 43,471評論 1 374
  • 序言:一個(gè)原本活蹦亂跳的男人離奇死亡,死狀恐怖,靈堂內(nèi)的尸體忽然破棺而出,到底是詐尸還是另有隱情,我是刑警寧澤,帶...
    沈念sama閱讀 39,009評論 5 363
  • 正文 年R本政府宣布,位于F島的核電站,受9級特大地震影響,放射性物質(zhì)發(fā)生泄漏。R本人自食惡果不足惜,卻給世界環(huán)境...
    茶點(diǎn)故事閱讀 44,698評論 3 348
  • 文/蒙蒙 一、第九天 我趴在偏房一處隱蔽的房頂上張望。 院中可真熱鬧,春花似錦、人聲如沸。這莊子的主人今日做“春日...
    開封第一講書人閱讀 35,099評論 0 28
  • 文/蒼蘭香墨 我抬頭看了看天上的太陽。三九已至,卻和暖如春,著一層夾襖步出監(jiān)牢的瞬間,已是汗流浹背。 一陣腳步聲響...
    開封第一講書人閱讀 36,386評論 1 294
  • 我被黑心中介騙來泰國打工, 沒想到剛下飛機(jī)就差點(diǎn)兒被人妖公主榨干…… 1. 我叫王不留,地道東北人。 一個(gè)月前我還...
    沈念sama閱讀 52,204評論 3 398
  • 正文 我出身青樓,卻偏偏與公主長得像,于是被迫代替她去往敵國和親。 傳聞我的和親對象是個(gè)殘疾皇子,可洞房花燭夜當(dāng)晚...
    茶點(diǎn)故事閱讀 48,436評論 2 378

推薦閱讀更多精彩內(nèi)容

  • Spring Cloud為開發(fā)人員提供了快速構(gòu)建分布式系統(tǒng)中一些常見模式的工具(例如配置管理,服務(wù)發(fā)現(xiàn),斷路器,智...
    卡卡羅2017閱讀 134,823評論 18 139
  • Android 自定義View的各種姿勢1 Activity的顯示之ViewRootImpl詳解 Activity...
    passiontim閱讀 172,715評論 25 708
  • 02 你的收獲 你如果耐心的看完這篇文章,你會獲得些許收獲 對postman的使用有一個(gè)基(全)本(面)認(rèn)知 可以...
    亭子青年閱讀 29,624評論 0 18
  • Postman提供了一個(gè)多窗口和多標(biāo)簽界面讓您處理API。Postman努力保持清潔靈活的需求。它為您提供盡可能多...
    千夜閱讀 51,481評論 6 20
  • 今天下午回來特別累 躺倒床上就睡著了 夢到前女友來找我 胖了很多還帶了吃的 給了我一個(gè)胡子拉碴的吻 問我什么時(shí)候回上海
    blingbling就是我閱讀 107評論 0 0