數(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文件夾保存為集合
- 將包含RAML定義的存儲庫克隆到本地計(jì)算機(jī),或?qū)⑵浔镜乇4鏋槲募A。
- 單擊導(dǎo)入(Import)按鈕,然后選擇導(dǎo)入文件夾(Import Folder)選項(xiàng)卡。導(dǎo)入按鈕
- 單擊 選擇文件夾 (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文件另存為集合
將包含Swagger定義的存儲庫克隆到本地計(jì)算機(jī)。如果你已經(jīng)把它保存在本地的文件中,那當(dāng)然可以。
-
單擊導(dǎo)入( Import)按鈕,然后選擇導(dǎo)入文件( Import File)選項(xiàng)卡。如果文件夾中有很多不相關(guān)的Swagger文件,則可以通過文件夾導(dǎo)入器導(dǎo)入這些文件。
點(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文件是否采用正確的集合格式,可以使用我們的文件集合模式。
- 模式文件位于 http://schema.getpostman.com/json/collection/v1.0.0/collection.json。
- 相關(guān)文檔可以在http://schema.getpostman.com/json/collection/v1.0.0/docs/index.html找到 。
- 一切都整齊地存儲在GitHub https://github.com/postmanlabs/schemas上。
- 要查看使用我們的模式和is-my-json-valid (驗(yàn)證器)的數(shù)據(jù)驗(yàn)證示例 ,請查看 此博客文章。