Postman

Postman是一個(gè)可擴(kuò)展的API開(kāi)發(fā)和測(cè)試協(xié)同平臺(tái)工具，可以快速集成到CI/CD管道中。旨在簡(jiǎn)化測(cè)試和開(kāi)發(fā)中的API工作流。

Postman 工具有 Chrome 擴(kuò)展和獨(dú)立客戶(hù)端，推薦安裝獨(dú)立客戶(hù)端。

Postman 有個(gè) workspace 的概念，workspace 分 personal 和 team 類(lèi)型。Personal workspace 只能自己查看的 API，Team workspace 可添加成員和設(shè)置成員權(quán)限，成員之間可共同管理 API。

當(dāng)然我個(gè)人使用一般是不登錄的，因?yàn)榈卿浿髸?huì)自動(dòng)將你的測(cè)試歷史數(shù)據(jù)保存到賬戶(hù)里，你可以登陸網(wǎng)頁(yè)端進(jìn)行查看。
因?yàn)锳PI的很多數(shù)據(jù)是很敏感的，有的含有Token，或者就是一些私密信息，雖然Postman自己也強(qiáng)調(diào)說(shuō)這樣很安全，不會(huì)私下窺探用戶(hù)的信息之類(lèi)的，但是呢還是至少做一點(diǎn)有效的防范吧，自己不上傳，因?yàn)榫W(wǎng)絡(luò)并沒(méi)有絕對(duì)的安全。
所以我每次測(cè)試之后會(huì)將數(shù)據(jù)(Case)保存在本地，下次使用或者換設(shè)備的情況下將數(shù)據(jù)拷貝過(guò)來(lái)又可以繼續(xù)使用了。

下面正式開(kāi)始介紹如何使用Postman吧。

為什么選擇Postman?

如今，Postman的開(kāi)發(fā)者已超過(guò)1000萬(wàn)(來(lái)自官網(wǎng))，選擇使用Postman的原因如下:
簡(jiǎn)單易用 - 要使用Postman，你只需登錄自己的賬戶(hù)，只要在電腦上安裝了Postman應(yīng)用程序，就可以方便地隨時(shí)隨地訪問(wèn)文件。
使用集合 - Postman允許用戶(hù)為他們的API調(diào)用創(chuàng)建集合。每個(gè)集合可以創(chuàng)建子文件夾和多個(gè)請(qǐng)求。這有助于組織測(cè)試結(jié)構(gòu)。
多人協(xié)作 - 可以導(dǎo)入或?qū)С黾虾铜h(huán)境，從而方便共享文件。直接使用鏈接還可以用于共享集合。
創(chuàng)建環(huán)境 - 創(chuàng)建多個(gè)環(huán)境有助于減少測(cè)試重復(fù)(DEV/QA/STG/UAT/PROD)，因?yàn)榭梢詾椴煌沫h(huán)境使用相同的集合。這是參數(shù)化發(fā)生的地方，將在后續(xù)介紹。
創(chuàng)建測(cè)試 - 測(cè)試檢查點(diǎn)(如驗(yàn)證HTTP響應(yīng)狀態(tài)是否成功)可以添加到每個(gè)API調(diào)用中，這有助于確保測(cè)試覆蓋率。
自動(dòng)化測(cè)試 - 通過(guò)使用集合Runner或Newman，可以在多個(gè)迭代中運(yùn)行測(cè)試，節(jié)省了重復(fù)測(cè)試的時(shí)間。
調(diào)試 - Postman控制臺(tái)有助于檢查已檢索到的數(shù)據(jù)，從而易于調(diào)試測(cè)試。
持續(xù)集成——通過(guò)其支持持續(xù)集成的能力，可以維護(hù)開(kāi)發(fā)實(shí)踐。

如何下載安裝Postman？

Step 1） 官網(wǎng)主頁(yè)：https://www.postman.com/downloads/， 下載所需版本進(jìn)行安裝即可。

Step2）安裝完成之后會(huì)要求你必須登錄才能使用，沒(méi)有賬號(hào)可以進(jìn)行注冊(cè)，注冊(cè)是免費(fèi)的。(也可使用Google賬號(hào)，不過(guò)基本不能登錄，你懂的)

Step3）在Workspace選擇你要使用的工具并點(diǎn)擊“Save My Preferences”保存。

Step4）你將看到啟動(dòng)后的頁(yè)面如下

如何使用Postman?

下圖是Postman的工作區(qū)間，各個(gè)模塊功能的介紹如下：

1、New，在這里創(chuàng)建新的請(qǐng)求、集合或環(huán)境；還可以創(chuàng)建更高級(jí)的文檔、Mock Server 和 Monitor以及API。
2、Import，這用于導(dǎo)入集合或環(huán)境。有一些選項(xiàng)，例如從文件，文件夾導(dǎo)入，鏈接或粘貼原始文本。
3、Runner，可以通過(guò)Collection Runner執(zhí)行自動(dòng)化測(cè)試。后續(xù)介紹。
4、Open New，打開(kāi)一個(gè)新的標(biāo)簽，Postman窗口或Runner窗口。
5、My Workspace - 可以單獨(dú)或以團(tuán)隊(duì)的形式創(chuàng)建新的工作區(qū)。
6、Invite - 通過(guò)邀請(qǐng)團(tuán)隊(duì)成員在工作空間上進(jìn)行協(xié)同工作。
7、History - 所有秦秋的歷史記錄，這樣可以很容易地跟蹤你所做的操作。
8、Collections - 通過(guò)創(chuàng)建集合來(lái)組織你的測(cè)試套件。每個(gè)集合可能有子文件夾和多個(gè)請(qǐng)求。請(qǐng)求或文件夾也可以被復(fù)制。
9、Request tab - 這將顯示您正在處理的請(qǐng)求的標(biāo)題。默認(rèn)對(duì)于沒(méi)有標(biāo)題的請(qǐng)求會(huì)顯示“Untitled Request”。
10、HTTP Request - 單擊它將顯示不同請(qǐng)求的下拉列表，例如 GET, POST, COPY, DELETE, etc. 在測(cè)試中，最常用的請(qǐng)求是GET和POST。
11、Request URL - 也稱(chēng)為端點(diǎn)，顯示API的URL。.
12、Save - 如果對(duì)請(qǐng)求進(jìn)行了更改，必須單擊save，這樣新更改才不會(huì)丟失或覆蓋。
13、Params - 在這里將編寫(xiě)請(qǐng)求所需的參數(shù)，比如Key - Value。
14、Authorization - 為了訪問(wèn)api，需要適當(dāng)?shù)氖跈?quán)。它可以是Username、Password、Token等形式。
15、Headers - 請(qǐng)求頭信息
16、Body - 請(qǐng)求體信息，一般在POST中才會(huì)使用到
17、Pre-request Script - 請(qǐng)求之前 先執(zhí)行腳本，使用設(shè)置環(huán)境的預(yù)請(qǐng)求腳本來(lái)確保在正確的環(huán)境中運(yùn)行測(cè)試。
18、Tests - 這些腳本是在請(qǐng)求期間執(zhí)行的。進(jìn)行測(cè)試非常重要，因?yàn)樗O(shè)置檢查點(diǎn)來(lái)驗(yàn)證響應(yīng)狀態(tài)是否正常、檢索的數(shù)據(jù)是否符合預(yù)期以及其他測(cè)試。
19、Settings - 最新版本的有設(shè)置，一般用不到。

如何處理GET請(qǐng)求

Get請(qǐng)求用于從指定的URL獲取信息，不會(huì)對(duì)端點(diǎn)進(jìn)行任何更改。
在這里我們使用如下的URL作為演示：

https://jsonplaceholder.typicode.com/users	

在Postman的工作區(qū)中：
1、選擇HTTP請(qǐng)求方式為GET
2、在URL區(qū)域輸入 鏈接
3、點(diǎn)擊 “Send”按鈕
4、你將看到下方返回200狀態(tài)碼
5、在正文中應(yīng)該有10個(gè)用戶(hù)結(jié)果，表明您的測(cè)試已經(jīng)成功運(yùn)行。

注意：在某些情況下，Get請(qǐng)求失敗可能由于URL無(wú)效或需要身份驗(yàn)證。

如何處理POST請(qǐng)求

Post請(qǐng)求與Get請(qǐng)求不同，因?yàn)榇嬖谟脩?hù)向端點(diǎn)添加數(shù)據(jù)的數(shù)據(jù)操作。使用之前GET 請(qǐng)求中相同數(shù)據(jù)，現(xiàn)在添加我們自己的用戶(hù)。
Step 1）創(chuàng)建一個(gè)新請(qǐng)求

Step 2 ）在新請(qǐng)求中
1、選擇HTTP請(qǐng)求方式為GET
2、在URL區(qū)域輸入 鏈接：https://jsonplaceholder.typicode.com/users
3、切換到Body選項(xiàng)

Step 3） Body選項(xiàng)
1、選中raw選項(xiàng)
2、選擇JSON

Step 4） 復(fù)制前面GET請(qǐng)求返回的json內(nèi)容的第一節(jié)
更改id為11，更改name以及uesrname和email

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "Sincere@april.biz
	",
        "address": {
            "street": "Kulas Light",
            "suite": "Apt. 556",
            "city": "Gwenborough",
            "zipcode": "92998-3874",
            "geo": {
                "lat": "-37.3159",
                "lng": "81.1496"
            }
        },
        "phone": "1-770-736-8031 x56442",
        "website": "hildegard.org",
        "company": {
            "name": "Romaguera-Crona",
            "catchPhrase": "Multi-layered client-server neural-net",
            "bs": "harness real-time e-markets"
        }
    }
]

注意： 檢查Body里用到的JSON格式很重要，以確保數(shù)據(jù)正確。
檢測(cè)的工具比如：https://jsonformatter.curiousconcept.com/

Step 5 ）發(fā)送請(qǐng)求
1、完成上述的信息輸入，點(diǎn)擊Send按鈕
2、Status:應(yīng)該是201，顯示為創(chuàng)建成功
3、在Body里返回?cái)?shù)據(jù)

如何將請(qǐng)求參數(shù)化

數(shù)據(jù)參數(shù)化是Postman最有用的特征之一。你可以將使用到的變量進(jìn)行參數(shù)化，而不是使用不同的數(shù)據(jù)創(chuàng)建相同的請(qǐng)求，這樣會(huì)事半功倍，簡(jiǎn)潔明了。
這些數(shù)據(jù)可以來(lái)自數(shù)據(jù)文件或環(huán)境變量。參數(shù)化有助于避免重復(fù)相同的測(cè)試，可用于自動(dòng)化迭代測(cè)試。

參數(shù)通過(guò)使用雙花括號(hào)創(chuàng)建:{{sample}}。
比如下面的請(qǐng)求：

接下來(lái)創(chuàng)建一個(gè)參數(shù)化get請(qǐng)求：
Step 1） 創(chuàng)建一個(gè)參數(shù)化get請(qǐng)求
1、將HTTP請(qǐng)求設(shè)置為GET
2、輸入U(xiǎn)RL： https://jsonplaceholder.typicode.com/users；將鏈接的域名部分替換為參數(shù)，例如{{url}}。請(qǐng)求url現(xiàn)在應(yīng)該是{{url}}/users。
3、點(diǎn)擊Send按鈕。
應(yīng)該沒(méi)有響應(yīng)，因?yàn)槲覀儧](méi)有設(shè)置參數(shù)的源，如下圖：

Step 2) 使用環(huán)境設(shè)置所需的參數(shù)
1、點(diǎn)擊眼睛圖標(biāo)
2、單擊Edit將該變量設(shè)置為可在所有集合中使用的全局環(huán)境。

Step 3） 變量--variable
1、將名稱(chēng)設(shè)置為url，該url為https://jsonplaceholder.typicode.com
2、點(diǎn)擊保存按鈕

Step 4） 如果看到下面截圖的樣式，請(qǐng)單擊Close

Step 5 ） 回到你的Get請(qǐng)求頁(yè)面，然后單擊發(fā)送Send按鈕，Get請(qǐng)求應(yīng)該就會(huì)返回結(jié)果了，如下圖：

注意：請(qǐng)確保所有的參數(shù)都有準(zhǔn)確的源數(shù)據(jù)，不管是環(huán)境變量還是數(shù)據(jù)文件，以避免出錯(cuò)。

如何創(chuàng)建Postman Tests

Postman Tests在請(qǐng)求中添加JavaScript代碼來(lái)協(xié)助驗(yàn)證結(jié)果，如：成功或失敗狀態(tài)、預(yù)期結(jié)果的比較等等。
通常從pm.test開(kāi)始。它可以與斷言相比較，驗(yàn)證其他工具中可用的命令。
接下來(lái)創(chuàng)建一個(gè)包含Tests的請(qǐng)求：
Step 1） 創(chuàng)建一個(gè)Get請(qǐng)求
1、切換到Tests選項(xiàng)，右邊是代碼片段選項(xiàng)。
2、從右邊的代碼片段選項(xiàng)里面選中 “Status code: Code is 200”
3、JS代碼就自動(dòng)出現(xiàn)在窗口中

Step 2) 點(diǎn)擊發(fā)送請(qǐng)求按鈕。測(cè)試結(jié)果就顯示出來(lái)了，如下圖：

Step 3) 回到Tests選項(xiàng)卡，讓我們添加另一個(gè)測(cè)試。這次我們將比較預(yù)期結(jié)果和實(shí)際結(jié)果。
在右邊的SNIPPETS區(qū)域選擇"Response body:JSON value check"選項(xiàng)，我們將檢查L(zhǎng)eanne Graham是否擁有userid 1。

Step 4）
1、將代碼中的“Your Test Name”替換為“Check if user with id1 is Leanne Graham”，以便測(cè)試名稱(chēng)確切描述我們想測(cè)試的內(nèi)容。
2、使用jsonData[0].name代替jsonData.value; 獲取路徑，在獲取結(jié)果之前檢查Body。因?yàn)長(zhǎng)eanne Graham是userid 1，所以jsonData在第一個(gè)結(jié)果中，這個(gè)結(jié)果應(yīng)該從0開(kāi)始。如果你想獲得第二個(gè)結(jié)果，那么對(duì)后續(xù)結(jié)果使用jsonData[1] 即可。
3、在eql中，輸入“Leanne Graham”

pm.test("Check if user with id1 is Leanne Graham", function () {
    var jsonData = pm.response.json();
    pm.expect(jsonData[0].name).to.eql("Leanne Graham");
});

Step 5) 點(diǎn)擊發(fā)送請(qǐng)求，可以看到你的請(qǐng)求之后測(cè)試結(jié)果中有兩項(xiàng)顯示測(cè)試通過(guò)。

注意：
有不同種類(lèi)的測(cè)試可以在Postman中創(chuàng)建。嘗試探索這個(gè)工具，看看哪些測(cè)試適合你實(shí)際測(cè)試。

如何創(chuàng)建測(cè)試集合

集合在組織測(cè)試套件中扮演著重要的角色。它可以被導(dǎo)入和導(dǎo)出，使得在團(tuán)隊(duì)之間共享集合變得很容易。在本教程中，我們將學(xué)習(xí)如何創(chuàng)建和執(zhí)行集合。

Step 1) 單擊頁(yè)面左上角的New按鈕，如下圖：

Step 2) 選擇Collection(集合). 創(chuàng)建collection窗口彈出，如下圖.

Step 3) 輸入所需的集合名稱(chēng)和描述，然后單擊create。
現(xiàn)在已經(jīng)創(chuàng)建了一個(gè)集合。

Step 4 ) 和前面的Get請(qǐng)求一樣，點(diǎn)擊保存。

Step5 ）
1、選擇Postman 測(cè)試集合(Test Collection)。
2、點(diǎn)擊保存Postman Test Collection

Step 6) Postman test collection現(xiàn)在應(yīng)該包含了一個(gè)請(qǐng)求，如下圖：

Step 7) 重復(fù)上述的Step4-5，繼續(xù)創(chuàng)建請(qǐng)求，這樣，測(cè)試集合就應(yīng)該有2個(gè)請(qǐng)求了，如下圖。

如何使用Collection Runner 運(yùn)行集合

有兩種方式來(lái)運(yùn)行一個(gè)集合，即Collection Runner和Newman。
Collection Runner:
Step 1) 單擊頁(yè)面頂部導(dǎo)入按鈕旁邊的Runner按鈕，如下圖。

Step 2）Collection Runner頁(yè)面應(yīng)該出現(xiàn)如下所示。以下是對(duì)各個(gè)字段的描述

Step 3) 做如下設(shè)置，運(yùn)行你的測(cè)試集合

選擇Postman測(cè)試集合-集合迭代次數(shù)為3
設(shè)置延遲為2500毫秒
點(diǎn)擊Start Run按鈕

Step 4) 單擊Run按鈕后將顯示Run結(jié)果頁(yè)。根據(jù)延遲的不同，你應(yīng)該在測(cè)試執(zhí)行的同時(shí)看到顯示的結(jié)果。

1、一旦測(cè)試完成，你就可以看到測(cè)試狀態(tài)是通過(guò)還是失敗，以及每個(gè)迭代的結(jié)果。
2、你將看到Get請(qǐng)求的Pass狀態(tài)；
3、由于我們沒(méi)有任何Post測(cè)試，所以應(yīng)該會(huì)出現(xiàn)請(qǐng)求沒(méi)有任何測(cè)試的消息。

可以出在請(qǐng)求中進(jìn)行測(cè)試是多么重要，這樣你就可以驗(yàn)證HTTP請(qǐng)求狀態(tài)是否成功，以及是否創(chuàng)建或檢索了數(shù)據(jù)。

如何使用Newman運(yùn)行集合

運(yùn)行集合的另一種方式是通過(guò)Newman。Newman和Collection Runner之間的主要區(qū)別如下:
1、Newman是Postman的替代品，所以需要單獨(dú)安裝Newman；
2、Newman使用命令行，而Collection Runner使用UI界面；
3、Newman可以用于持續(xù)集成。

安裝Newman并運(yùn)行Collection，步驟如下:
Step 1) 下載并安裝NodeJs: http://nodejs.org/download/
Step 2) 打開(kāi)命令行窗口并輸入下面命令：

npm install -g newman

安裝后 如下圖：

Step 3 ）
Newman安裝好之后，讓我們回到Postman的workspace。在Collections框中，單擊三個(gè)點(diǎn) ... 會(huì)出現(xiàn)新的選擇選項(xiàng)，可看到Export選項(xiàng)，如下圖：

Step 4 ）
選擇導(dǎo)出集合，默認(rèn)使用推薦的集合版本，比如此處是v2.1，然后單擊導(dǎo)出：

Step 5 ） 選擇你想要保存的地址之后點(diǎn)擊保存，這里建議專(zhuān)門(mén)新建一個(gè)文件夾來(lái)存放你的Postman tests。
Step 6 ） 另外還需要導(dǎo)出我們的環(huán)境(enviroment)。單擊全局環(huán)境下拉菜單旁邊的eye圖標(biāo)，選擇JSON格式下載。選擇你想要的位置，然后單擊Save。最好將環(huán)境放在與Step5 導(dǎo)出的集合相同的文件夾中。

Step 7 ） 導(dǎo)出Environment 到集合文件夾后，現(xiàn)在回到命令行，將目錄更改為保存集合和環(huán)境的位置。

cd C:\Users\Asus\Desktop\Postman Tests

Step 8 ） 使用下面的命令運(yùn)行你的測(cè)試集合：

newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

運(yùn)行的結(jié)果應(yīng)該如下圖：

關(guān)于Newman的一些基礎(chǔ)指導(dǎo)如下：
1、只運(yùn)行集合（如果沒(méi)有環(huán)境或測(cè)試數(shù)據(jù)文件依賴(lài)關(guān)系，則可以使用此選項(xiàng)。）

newman run <collection name> 

2、運(yùn)行集合和環(huán)境（參數(shù)-e 是environment）

newman run <collection name> -e <environment name> 

3、使用所需的編號(hào)運(yùn)行集合的迭代。

newman run <collection name> -n <no.of iterations>

4、運(yùn)行數(shù)據(jù)文件

newman run <collection name> --data <file name>  -n <no.of iterations> -e <environment name> 

5、設(shè)置延遲時(shí)間。(這一點(diǎn)很重要，因?yàn)槿绻捎谡?qǐng)求在后臺(tái)服務(wù)器上，完成前一個(gè)請(qǐng)求時(shí)沒(méi)有延遲時(shí)間直接啟動(dòng)下一個(gè)請(qǐng)求，測(cè)試可能會(huì)失敗。)

newman run <collection name> -d <delay time>

***********若有錯(cuò)誤歡迎指正
歡迎關(guān)注微信公眾號(hào)【軟測(cè)小生】，號(hào)內(nèi)有大量免費(fèi)軟件測(cè)試學(xué)習(xí)資料，歡迎自取，還望多多交流軟件測(cè)試相關(guān)的內(nèi)容*********

總結(jié)

以上是生活随笔為你收集整理的API测试之Postman使用完全指南(Postman教程，这篇文章就够了)的全部?jī)?nèi)容，希望文章能夠幫你解決所遇到的問(wèn)題。

如果覺(jué)得生活随笔網(wǎng)站內(nèi)容還不錯(cuò)，歡迎將生活随笔推薦給好友。