2. 程式人生 > >API自動化測試利器——Postman

API自動化測試利器——Postman

阿新 • • 發佈：2019-01-31

自從開始做API開發之後，我就在尋找合適的API測試工具。一開始不是很想用Chrome擴充套件，用的WizTools的工具，後來試過一次Postman之後就停不下來了，還買了付費的Jetpacks。推出Team Sync Beta之後我又把這個工具推廣給團隊，作為API文件使用。看到中文網路上關於這個工具的文章並不多，於是決定寫一篇小文介紹一下。

一、基本功能

Postman的功能在文件中有介紹。不過文件略囉嗦，這裡簡單介紹一下主介面，入門功能就都提到了。
postman_mark.png

  1. Collections：在Postman中，Collection類似資料夾，可以把同一個專案的請求放在一個Collection裡方便管理和分享，Collection裡面也可以再建資料夾。如果做API文件的話，可以每個API對應一條請求，如果要把各種輸入都測到的話，就需要每條測試一條請求了。這裡我新建了一個example用於介紹整個流程，五個API對應五條請求。這個Collection可以通過https://www.getpostman.com/collections/c8f98a1120357e0d4a5a

    匯入你自己的Postman中。

  2. 上面的黑字註冊是請求的名字，如果有Request description的話會顯示在這下面。下面的藍字是儲存起來的請求結果，點選可以載入某次請求的引數和返回值。我會用這個功能給做客戶端的同事展示不同情況下的各種返回值。儲存請求的按鈕在15.

  3. 選擇HTTP Method的地方，各種常見的不常見的非常全。

  4. 請求URL，兩層大括號表示這是一個環境變數，可以在16的位置選擇當前的environment，環境變數就會被替換成該environment裡variable的值。

  5. 點選可以設定URL引數的key和value

  6. 點擊發送請求

  7. 點選儲存請求到Collection，如果要另存為的話，可以點選右邊的下箭頭

  8. 設定鑑權引數，可以用OAuth之類的

  9. 自定義HTTP Header，有些因為Chrome願意不能自定義的需要另外裝一個外掛Interceptor，在16上面一行的衛星那裡

  10. 設定Request body，13那裡顯示的就是body的內容

  11. 在發起請求之前執行的指令碼，例如request body裡的那兩個random變數，就是每次請求之前臨時生成的。

  12. 在收到response之後執行的測試，測試的結果會顯示在17的位置

  13. 有四種形式可以選擇，form-data主要用於上傳檔案。x-www-form-urlencoded是表單常用的格式。raw可以用來上傳JSON資料

  14. 返回資料的格式，Pretty可以看到格式化後的JSON，Raw就是未經處理的資料，Preview可以預覽HTML頁面

  15. 點選這裡把請求儲存到2的位置

  16. 設定environment variables和global variables，點選右邊的x可以快速檢視當前的變數。

  17. 測試執行的結果，一共幾個測試，通過幾個。

這個介面就是免費版的主要內容，和其他API測試工具相比，已經足夠好用。如果要使用自動化測試，需要購買9.99美金的Jetpacks，暫時不想購買的話可以試一下Team版Postman。現在是可以免費試用的，不但擁有Jetpacks的功能，還能與其他賬戶同步Collection。

二、測試工具

測試工具主要包括三部分，在發起請求之前執行的Pre-request，在收到應答之後執行的Test，和一次執行所有請求的Collection Runner

1. Pre-request

Pre-request的編寫介面如下：

pre.png

Pre-request和Test用的語言都是JavaScript，Postman在一個沙盒裡執行程式碼，提供給使用者的庫和函式可以在這裡檢視。而常用的功能都可以通過右邊的Code Snippets實現，點選就可以插入到程式碼區域。

可以看到Pre-request裡常用的功能就兩種，設定環境變數和設定全域性變數。這條請求的pre-request就是在註冊之前生成一個字串作為隨機使用者名稱。

postman.setEnvironmentVariable("random_username", ("0000" + (Math.random()*Math.pow(36,4) << 0).toString(36)).slice(-4));

其他用法還包括在發起請求之前獲取當前的時間戳放在引數裡：

postman.setEnvironmentVariable("unixtime_now", Math.round(new Date().getTime()/1000));

當然也可以用來生成校驗串。總之，在發請求之前需要手動修改的東西，都可以考慮用指令碼自動實現。

2. Test

Test的編寫介面如下：

test.png

和Pre-request相比，Test的Snippets就豐富多了，例如檢查狀態碼、檢查響應串、驗證JSON、檢查header、限制應答時間。

如果需要將伺服器響應的資料儲存下來，用在後面的請求裡，也需要在這一步做。

在圖中的Test裡，我首先檢查了狀態碼為200，然後解析返回的JSON，把環境變數裡的token設為JSON裡的token。

3. Collection Runner

當編寫了很多測試之後，就可以使用Collection Runner來自動執行整個Collection了，入口就在主介面最上面一行的Runner。選好Collection、Environment，如果有需要還可以載入JSON和CSV作為資料來源。點選Start Test Run，就可以看到結果了。

runner.png

這裡可以看到一共發起了5次請求，每個請求各有一個Test，全部Pass。（雖然最後一個請求的返回是403，但是這個請求的期望返回值就是403，所以也是Pass的）

三、示例

最後完整的看一下我用的例程。這個例子是一個非常簡單的小系統，使用者可以註冊並登入，然後在系統裡新建充值卡，並給這張卡充值。整個流程如下：

1. 註冊

生成一個隨機字串作為使用者名稱和暱稱

postman.setEnvironmentVariable("random_username", ("0000" + (Math.random()*Math.pow(36,4) << 0).toString(36)).slice(-4));

發起請求

POST /index.php/users HTTP/1.1
Host: postmanexample.bayes.cafe
Cache-Control: no-cache
Postman-Token: 76791813-aac2-71fb-cad4-3e737f37c4d0
Content-Type: application/x-www-form-urlencoded

username=2mjk&password=123456&nickname=2mjk

執行測試、檢查結果

tests["Status code is 201"] = responseCode.code === 201;

2. 登入

直接用剛才生成的環境變數發起請求

POST /index.php/authentication HTTP/1.1
Host: postmanexample.bayes.cafe
Cache-Control: no-cache
Postman-Token: aac7d0ac-e0e3-ecf2-39da-b8dca672e3d7
Content-Type: application/x-www-form-urlencoded

username=2mjk&password=123456

執行測試、檢查結果，並將返回的token記錄下來

tests["Status code is 200"] = responseCode.code === 200;

var data = JSON.parse(responseBody);
postman.setEnvironmentVariable("token", data.token);

3. 新增一張卡

先生成一個卡號和卡名

postman.setEnvironmentVariable("random_cardno", Math.round(Math.random()*9999999));

postman.setEnvironmentVariable("random_cardname", ("0000" + (Math.random()*Math.pow(36,4) << 0).toString(36)).slice(-4));

然後發起請求，這裡呼叫了剛才獲取到的Token，放在header的自定義欄位裡作為鑑權（SAE不能用Authorization這個欄位，不清楚原因）

POST /index.php/cards HTTP/1.1
Host: postmanexample.bayes.cafe
X-Authorization: d4c4a0b7b36c73e7a13b7e24a596093b
Cache-Control: no-cache
Postman-Token: d44d573f-f17a-366c-2cd7-1d5b8b709233
Content-Type: application/x-www-form-urlencoded

cardno=1385526&desc=2mo8

執行測試

tests["Status code is 200"] = responseCode.code === 200;

4. 查詢剛才生成的卡

發起請求，呼叫了剛才生成的卡號

GET /index.php/cards/1385526 HTTP/1.1
Host: postmanexample.bayes.cafe
Cache-Control: no-cache
Postman-Token: 1e5aca57-c3bb-7404-2791-c639cd60b5c8

執行驗證，和剛才生成的卡名對比，並記錄新卡的ID

var data = JSON.parse(responseBody);
tests["check cardname"] = data.desc === environment.random_cardname;

postman.setEnvironmentVariable("new_card_id", data.id);

5. 充值

發起請求，使用了剛才獲得的新卡ID

POST /index.php/deposit HTTP/1.1
Host: postmanexample.bayes.cafe
X-Authorization: d4c4a0b7b36c73e7a13b7e24a596093b
Cache-Control: no-cache
Postman-Token: 388c95e0-b5ce-9bbf-5816-084db7523384
Content-Type: application/x-www-form-urlencoded

cardid=1&amount=10

執行驗證（由於是新建的使用者，沒有餘額，無法給卡片充值，故返回403 Forbidden）

tests["Status code is 403"] = responseCode.code === 403;

P.S.postmanexample.bayes.cafe這個網站是真實存在的，可以Import我上傳的Collection(https://www.getpostman.com/collections/96b64a7c604072e1e4ee)到你自己的Postman中，並設定環境變數url為http://postmanexample.bayes.cafe，就能執行這個Collection看效果了。

伺服器端程式的程式碼已經在GitHub開源。

轉載自：http://www.bayescafe.com/tools/use-postman-to-test-api-automatically.html

相關推薦

API自動化測試利器——Postman

自從開始做API開發之後，我就在尋找合適的API測試工具。一開始不是很想用Chrome擴充套件，用的WizTools的工具，後來試過一次Postman之後就停不下來了，還買了付費的Jetpacks。推出Team Sync Beta之後我又把這個工具推廣給團隊，作為API

REST API 自動化測試 利器Rest Assured（API接口自動化測試框架體系）

系統 網站 中文 load bsp acl ava download ext 現在，越來越多的 Web 應用轉向了 RESTful 的架構，很多產品和應用暴露給用戶的往往就是一組 REST API，這樣有一個好處，用戶可以根據需要，調用不同的 API，整合出自己的應用出來。

HTTP API接口測試利器PostMan介紹

inter cdr 能力 rom 取數據 沒有 smo earch 進行 一、什麽是API接口測試？ API接口有多種，個人將其劃分為三類。第一種是函數級別的，測試需要對接口的各個參數進行測試，如：Int getResult（String key， String ID， I

Postman+Newman+jenkins實現API自動化測試

bat 測試 選項 命令 www. 思路 9.png 回顧 linux 　　最近自己在學習用postman+newman+jenkins實現API自動化測試，這裏做個回顧和記錄。（此次是在windows上進行的環境搭建） 一、說明 　　1.大致思路：利用postman做

基於Postman的API自動化測試

chrome插件 url參數 oda -c ndb 瀏覽器 求和 mbo 不同的 https://segmentfault.com/a/1190000005055899 1. 安裝 兩種安裝方式，我熱衷於以chrome插件形式安裝 Chrome插件 Mac A

Postman + newman + jenkins 的API自動化測試應用

exit mar back written put cts tca ins call 一、環境配置 Postman postman 的具體使用可以參考另外一篇文章：postman 做接口測試之學習筆記 Newman 第一步，安裝nodejs。 第二步，在nodejs命令

Jenkins+postman+Newman之API自動化測試

java c11 col hide lena clas set webapp nload 操作環境：Windows、Jenkins、Java、Tomcat、nodejs、Newman、postman 安裝jdk並設置環境變量-->安裝Tomcat並設置環境變量--&g

<API自動化測試>Centos-Newman

應用程序 語言 微軟雅黑 小白 定時 指導 ogl 應用 能夠 一、介紹： 在測試和開發中，有一款API測試工具一直占據著武林盟主的地位，那就是聲名遠播的Google公司的Postman。 Postman原先是Chrome瀏覽器的一個插件，後面發展成了一個應用程序，一直

使用Pandaria編寫API自動化測試進階用法

簡介 Pandaria是一款基於Cucumber JVM的API自動化測試工具，上一篇文章介紹了它的基本功能，包括基本的HTTP操作和資料庫操作。本文將介紹使用Pandaria編寫自動化測試的一些高階用法。 快速開始 安裝 Pandaria本身以Java庫的形式釋出到Maven Central中，使用

HTTP API 自動化測試從手工測試到平臺的演變

del ann ges robot 對數 經歷 說明 熱鬧 技術網站 不管是 Web 系統，還是移動 APP，前後端邏輯的分離設計已經是常態化，相互之間通過 API 調用進行數據交互。在基於 API 約定的開發模式下，如何加速請求 / 響應的 API 測試，讓研發人員及早參

web前端自動化測試利器puppeteer介紹

web前端自動化測試利器puppeteer介紹 Intro Chrome59(linux、macos)、 Chrome60(windows)之後，Chrome自帶headless(無介面)模式很方便做自動化測試或者爬蟲。但是如何和headless模式的Chrome互動則是一個問題。通過啟動Chrome時的

HTTP API 自動化測試從手工到平臺的演變

不管是 Web 系統，還是移動 APP，前後端邏輯的分離設計已經是常態化，相互之間通過 API 呼叫進行資料互動。在基於 API 約定的開發模式下，如何加速請求 / 響應的 API 測試，讓研發人員及早參與到除錯中來呢？既然 API 是基於約定開發，為何不按照這個規範編寫測試用例，直接進入待測

OpenStack Rally 質量評估與自動化測試利器

目錄 文章目錄 目錄 問題描述 Rally 簡介 應用場景 應用案例 Rally 安裝 Rally 使用 Rally 架構 Rally Plugin 分析與實現 程式入

python unittest做api自動化測試

專案測試對於一個專案的重要性，大家應該都知道吧。 寫python的朋友，應該都寫過自動化測試指令碼。 最近正好負責公司專案中的api測試， 下面寫了一個簡單的例子，對API 測試進行梳理。 首先

API自動化測試實踐

API 測試的基本步驟 通常來講,API 測試的基本步驟主要包括以下三大步驟： 1、準備測試資料； 2、通過通用的或自己開發的API測試工具發起對被測API的request； 3、驗證返回結果的response。 常用的API測試工具有命令列工具cURL、圖形介面工具Postman或SoapUI，支援API效

Http和REST API 介面測試神器POSTMAN簡介

Rest API測試有2大神器，均和瀏覽器有關： Firefox --HttpRequest Chrome--Postman 其中HttpRequest在新的Firefox版本上暫時無法使用，不能說不說是一種遺憾，要想使用，得用開發者版。 1、Chrome 的Post

API自動化測試與持續整合

目的 如何使用SuperTest測試框架，進行API測試如何將API測試與構建工具結合如何將API測試、構建工具與持續整合結合SuperTest 什麼是SuperTest To provide a high-level abstraction for testing HTT

介面測試利器-postman

前言 介面測試要測試的請求絕大多數是restful風格的api, GET, PUT, POST, DELETE等方法, 瀏覽器中只能簡單的模擬GET請求, 如果是使用curl命令, 也不能對我們的介面api測試進行管理, postman可以滿足我們的所有需求 安

API 自動化測試框架分享

轉載地址：https://testerhome.com/topics/3455 框架定位 1，資料驅動 2，簡單流程覆蓋，快速迭代 3，組合Case不需要Coding 總而言之只要是程式碼能夠實現的，能方便API測試的都是框架定位的方向~！ 框架介紹

五大典型場景中的API自動化測試實踐

一、API 測試的基本步驟 通常來講,API 測試的基本步驟主要包括以下三大步驟： 1、準備測試資料； 2、通過通用的或自己開發的API測試工具發起對被測API的request； 3、驗證返回結果的response。 常用的API測試工具有命令列工具cURL、圖形介面工具Postman或SoapUI，支援AP