一、 Example
1、什么是Example
一個example例是一組請求和響應對;
開發人員可以在發送實際請求或設置單個端點返回響應之前, 在Postman中模擬請求和響應;
要在API開發的最早階段建立實例:需要團隊成員之間的清晰溝通、符合他們的期望、幫助開發人員和測試人員更快啟動項目;
2、為什么要使用Example
通常模擬並保存帶有請求的幾個示例響應(例如狀態碼)很有用, 以便你的API方便理解;
假設你要使用尚未存在的端點或你的服務器尚未准備就緒來構建API, 你可以模擬原始響應並將其保存;然后你將能夠使用Postman的模擬服務為每個終端生成模擬端點;
開發人員可以享模擬端點發出請求, 並根據從模擬端點返回的模擬響應開始前端開發或編寫測試;
3、添加一個Example
假設你正在處理保存在集合中的請求. 你可以使用新的自定義響應或服務器的響應向此請求添加示例;
(1)、打開一個請求, 點擊右上角的Example添加;
(2)、輸入name和請求url,可以設置請求參數;
(3)、設置返回的狀態碼和響應內容,響應內容可以是json、xml或文本格式;
(4)、點擊右上角的save Exmaple保存;
(5)、然后創建一個New--》mock server;
(6)、選擇集合;
(7)、在“Set up the mock server”下,點擊“Create Mock Server”;
(8)、在“Next steps”下,會顯示的一個請求的URL;
(9)、訪問在“Next steps”下顯示的URL,響應的結果是Exmaple里設置好的內容, 並非百度網頁返回的響應內容;
二、 導入導出
PostMan可以將收藏,環境,全局變量和標題預設導出和導出為文件和鏈接;
1、導出Postman資料
PostMan可以導出和導入以下格式作為文件或生成的URL;從Postman應用程序導出集合時,導出的文件是一個JSON文件;該文件包含Postman在導入Postman時重新創建集合所需的所有數據(和元數據),或由Newman從命令行界面(CLI)運行集合所使用的所有數據(和元數據);
(1)、集合Collections導出,文件格式是 json文件;
(2)、環境Environments導出;
(3)、所有數據導出,文件格式是 json文件;
2、導入Postman資料
(1)、postman數據可以從SETTINGS 模式的“ Data” 選項卡中導入,也可以使用頭文件工具欄中的“ 導入”按鈕導入;
(2)、IMPORT模式導入collection, environment, data dump, cUrl command或RAML / WADL / Swagger(v1 / v2)/ Runscope文件;
(3)、導入cURL
①、最有效的cURL(僅HTTP)命令可以導入Postman。PostMan的import支持以下cURL選項;
②、從charles等抓包工具中請求地址復制為CURL粘貼至postman可直接生成接口請求;
③、從chrome等瀏覽器中請求地址復制為CURL粘貼至postman可直接生成接口請求;
(4)、導入RAML
①、將RAML文件夾保存為集合;
②、將包含RAML定義的存儲庫克隆到本地計算機,或將其本地保存為文件夾;
③、單擊導入(Import)按鈕,然后選擇導入文件夾(Import Folder)選項卡;
④、單擊選擇文件夾 (Choose Folders)並上傳RAML文件夾;
(5)、導入Swagger
Swagger API定義通常以單個文件的形式存在,因此我們只支持導入單個swagger文件。如果文件夾中有很多不相關的Swagger文件,則可以通過文件夾導入器導入這些文件;
①、將Swagger文件另存為集合;
②、將包含Swagger定義的存儲庫放到到本地計算機;
③、單擊導入( Import)按鈕,然后選擇導入文件( Import File)選項卡;如果文件夾中有很多不相關的Swagger文件,則可以通過文件夾導入器導入這些文件;
④、點擊文件並上傳Swagger文件;
(6)、導入WADL
PostMan也可以導入WADL規范。雖然所有方面都不受支持,但您可以期待Postman使用的各種參數(集合,文件夾,請求,標頭,請求有效載荷(Collection, folder, request, header, request payload))正確生成。