Postman使用詳解

前言：

Postman是一款功能強大的網頁調試與發送網頁HTTP請求的Chrome插件。

接口請求流程

一、get請求

GET請求：點選Params，輸入參數及value，可輸入多個，即時顯示在URL連結上，是以，GET請求的請求頭與請求參數如在接口文檔中無特别聲明時，可以不填。

get請求示例

GET響應：右上角顯示響應HTTP狀态碼、請求的耗時。

get響應示例

需特别注意的是注意差別HTTP狀态碼與響應正文中的狀态碼，隻有HTTP狀态碼是200時，才代表這個接口請求是正确的，這個是HTTP協定定義的，而響應正文的狀态碼，是程式員自已定義的，可以是200，也可以定義為其它值，是為了讓接口使用者去區分正常資料與異常資料。

狀态碼與響應碼不一緻

二、POST請求

1、POST請求一：表單送出

先看下圖POST表單送出示例：

表單送出示例

上圖示例中設定了請求方法，請求URL，請求參數，但沒有設定請求頭。有一個要明确的點是，請求頭中的Content-Type與請求參數的格式之間是有關聯關系的。

Content-Type與請求參數的格式之間的關聯

當選擇x-www-form-urlencoded的參數方式後，postman自動的幫我們設定了Content-Type，是以不需要我們人工幹預，這就是使用一款流行工具的好處，把一些基礎點都幫我們處理了。

2、POST請求二：json送出

先看下圖json送出示例：

json送出示例

上圖中，當我們選擇了JSON(application/json)時，postman同樣幫我們自動設定了Content-Type，可以自行的去檢視Headers.

3、post請求三：xml送出

先看下圖XML送出示例：

XML送出示例

上圖中，當我們選擇了XML(text/xml)時，postman同樣幫我們自動設定了Content-Type，可以自行的去檢視Headers.

4、post請求四：自行設定Content-Type

HTTP的POST請求的參數，都是放在請求正文中的，隻是根據Content-Type來判斷請求正文的格式，那麼我們同樣可以在表單送出時，選擇raw，然後自行設定Content-Type為application/x-www-form-urlencoded。

POST請求的參數

自行設定Content-Type

5、POST請求五：二進制檔案送出

先看下圖二進制檔案示例：

二進制檔案送出

Body下，選擇binary，在這裡你可以發送視訊、音頻、文本等檔案。

三、postman斷言

一個完整的接口測試，包括：請求->擷取響應正文->斷言，我們已經知道了請求與擷取響應正文，下面來介紹如何用postman進行斷言。

Tests

這個”Tests”就是我們需要處理斷言的地方，postman很人性化的幫我們把斷言所用的函數全給準備好了：

SNIPPETS

舉例說明：首先設定一個斷言場景，根據斷言場景來舉例說明Postman斷言如何使用。

1、判斷HTTP傳回狀态碼為200

2、判斷響應正文中是否包含："statusCode":200

3、解析響應正文，并判斷statusCode的值是200，message的值是”Success”

第一步：在SNIPPETS中，往下拉，有一項”Status code:Code is 200”，這個就是為場景中的第 1 條準備的，判斷HTTP傳回狀态碼是否為200。點選這一項，可以看到在其左邊，斷言代碼自動添加，見下圖：

Status code

解釋一下這句代碼的意思：

tests["Status code is 200"]中的tests是一個内置對象，tests["Status code is 200"]是指為這個斷言起個名稱叫”Status code is 200”，這個名稱可以自行修改。

responseCode.code === 200中的responseCode是内置對象，responseCode對象中有個屬性是code，是指HTTP狀态碼的code，判斷code是否為200.

綜合起來，這句代碼的意思是：名稱為”Status code is 200”的斷言中，判斷responseCode對象的code屬性值（HTTP狀态碼）是否為200。

第二步：同樣在SNIPPETS中，找到一項”Response body:Contains string”，這個就是為場景中的第2條準備的，判斷響應正文中的字段。點選後，在其左邊，斷言代碼自動添加，見下圖：

Contains string1

其中我們需要修改想要在響應封包中找到的内容：

tests["Body matches string"] = responseBody.has('"statusCode":200');    //對照第2條場景：判斷響應正文中是否包含："statusCode":200

Contains string2

第三步：我們需要解析JSON串了，是以，在SNIPPETS中找到”Response body:JSON value check”并點選，在其左邊，斷言代碼自動添加，見下圖：

JSON value check1

我們可以看出，這裡面其實是JS代碼，jsonData變量其實是解析完JSON後的對象，在JS中，一個JSON對象擷取其屬性的值，直接是用jsonData.value，于是，我們把代碼給修改一下，來判斷第3條場景：

tests["response statusCode"] = jsonData.statusCode === 200;  //判斷statusCode的值是200

tests["response message"] = jsonData.message === 'Success';  //判斷message的值是”Success”

JSON value check2

這樣一來，我們可以看到一共有Tests的斷言4個，點選Send，發送請求，在響應區内可以看到如下圖：表示斷言全部通過。

以上，SNIPPETS中還有很多的函數提供給我們,努力學習吧~~~

四、管理用例---Collections

Collections集合：也就是将多個接口請求可以放在一起，并管理起來。什麼樣的接口請求可以放在同一個collection裡？

在這裡告訴大家可以這樣：一個工程一個Collection，這樣友善查找及統一處理資料。

第一步：建立Collections

點選上圖中的帶+号的圖示，輸入Name:”demo”，Description:”demo for Collections”，點選Create按鈕即建立成功一個Collections.

Create Collections

第二步，在Collections裡添加請求

在右側準備好接口請求的所有資料，并驗證後，點選save按鈕。

save按鈕

選擇Collection及填寫好Request name、Request description後，點選右下角的save to collection按鈕，則該請求被添加到Collection中。

save request

添加成功後，可在左側清單中，collection中檢視剛剛添加的請求。

第三步：Collection精細化---Folder

随着放入Collection的請求越來越多，混亂就又出現了，在找一個請求時，要找半天，于是将collection中的請求分門類别就很重要了，于是，在collection中就可以添加Folder了，将相同場景的請求放入同一個Folder中，于是就實作了子產品化的管理了。

點選下圖中的Add Folder後，即可建立Folder。

Add Folder按鈕位置

添加上Folder name，即子產品名稱後，點選Create，建立成功一個Folder。

add Folder

接下來，隻需要把相同場景的請求拖入相同的Folder即可，這樣就實作了子產品化的管理了。子產品化以後的結構：

子產品化的管理結構

第四步：運作Collection

将工程子產品化的用例管理起來後，借着這個管理起來的東風，也可以将工程子產品化的用例執行起來，即一次執行一整個collection裡的用例，或者執行一個collection裡的某一個Folder裡的用例。

點選下圖中的Run：

run

下圖中的”Choose collection or folder”，如果選擇demo，表示運作demo這一整個collection的用例，如果選擇GET，即隻運作demo下的GET子產品下的用例。

Environment，即運作環境，是開發環境還是測試環境，需事先配置，大家可以下去自已嘗試一下。

Iterations，即重複運作次數。會将選擇好的collection中folder重複運作。

Delay，間隔時間。用例與用例間的間隔時間。

Data，外部資料加載，即用例的參數化，可以與Iterations結合起來用，實作參數化，也就是資料驅動。

Run Demo，點選運作，運作完成後，即可得出一個簡易的聚合報告。

第五步：Collection運作參數化

在Iterations重複運作時，如果某個用例希望每次運作時，使用不同的資料，那麼應該滿足如下2個條件：

1、腳本中要用到資料的地方參數化，即用一個變量來代替，每次運作時，重新擷取目前的運作資料。

2、需要有一個資料池，這個資料池裡的資料條數，要與重複運作的次數相同。

Postman的runner給我們提供了Iterations的輸入項，也提供了Data的檔案選擇項，也就是意味着資料池是一個外部檔案。

如果Iterations裡的值為2，那麼，這個外部檔案裡也應該有兩條資料，postman希望我們這個外部檔案裡的資料是一個json（當然也可以是其它

資料格式）.

為了表示兩條資料，這個json應該是一個list結構(如下圖)，同時，由于腳本要用到資料的地方需要參數化，需要變量，是以，每一條資料應該就是一個map，map的key對應腳本中的變量。

外部檔案裡的資料

上圖中表示提供了一個msg的變量，每次運作對應不同的值，預示着在腳本中可以用到msg這個變量，那在腳本中如何用？

使用變量

如上圖斷言中用data.msg，其中data是個内置對象，即代表每一次運作的那個map資料，是以，可以用data.msg來擷取每次運作的對應的值，當然，由于是個map，也可以用data[‘msg’]來擷取對應的值。

五、設定環境變量

有時需要在不同的環境下跑相同的測試，此時可以通過設定環境變量來動态選擇。點選右上角的設定按鈕-Manage Environments：

Manage Environments

填寫該環境的名稱：如測試環境，并在key和value中填寫需要的鍵值。

add1

add2

使用這些鍵值的時候隻需要加上兩個花括号引用key，例如： {{url_base}}/admin/offer/

引用key

建立多個環境時，key通常都是相同的，隻是value不同。建立好所有環境後，在跑用例的時候在右上角下拉清單選擇需要的環境就可以了。

選擇環境變量

六、身份驗證Authentication

顯示browser cookies，需要開啟Interceptor。點選右上角的Interceptor 進行安裝，并開啟：

Interceptor

身份驗證Authentication：

postman有一個helpers可以幫助我們簡化一些重複和複雜的任務。目前的一套helpers可以幫助你解決一些authentication protocols的問題。

1、Basic Auth

填寫使用者名和密碼，點選update request後，headers中自動添加Authorization。圖中使用者名和密碼均使用的key變量：

Basic Auth

2、Digest Auth

要比Basic Auth複雜的多。使用目前填寫的值生成authorization header。是以在生成header之前要確定設定的正确性。如果目前的header已經存在，postman會移除之前的header。

3、OAuth 1.0

postman的OAuth helper讓你簽署支援OAuth

1.0基于身份驗證的請求。OAuth不用擷取access token,你需要去API提供者擷取的。OAuth 1.0可以在header或者查詢參數中設定value。

4、OAuth 2.0

postman支援獲得OAuth 2.0 token并添加到requests中。

postman竟然如此之強大！我們還有什麼理由去拒絕？介紹完之後，可能新的問題又來了，如何與jenkins結合實作持續內建？

是以，産生了個newman，是個指令行運作postman請求的工具，建議大家自行去研究下，因為那确實就隻是個指令行的工具而已！

原文位址：https://www.cnblogs.com/yunman/p/7884537.html