【工具篇】接口測試神器 -- Postman 入門教程

1、Postman概述

（1）工具介紹

Postman是一個接口測試工具，一款很是流行的API調試工具。在作接口測試的時候，Postman至關於一個客戶端，它能夠模擬用戶發起的各種HTTP請求，將請求數據發送至服務端，獲取對應的響應結果，從而驗證響應中的結果數據是否和預期值相匹配；並確保開發人員可以及時處理接口中的bug，進而保證產品上線以後的穩定性和安全性。

軟件功能很是強大，界面簡潔明晰、操做方便快捷，設計得很人性化。

（2）工具特色

1. 簡單易用的圖形用戶界面；

2. 保存API請求的歷史記錄；

3. 無限制的使用集合、環境變量、運行測試和共享集合；

4. 可用集合Runner來自動化測試；

5. 靈活的API監控，運行時間、性能和準確；

6. 模擬服務器，支持split-stack開發。

（3）工具下載

一、Postman最先是做用chrome瀏覽器插件存在的，因此，你能夠到chrome商店搜索下載安裝。

二、Postman提供了獨立的安裝包，再也不依賴於Chrome瀏覽器。同時支持MAC、Windows和Linux，推薦獨立安裝。

      https://www.getpostman.com/apps

2、接口概述

（1）接口定義

 

 

接口：這裏特指軟件接口，是指對協定進行定義的引用類型。通俗講是就是軟件系統不一樣組成部分銜接的約定。

一般就是所謂的API （Application Programming Interface） 應用程序編程接口，其表現的形式是源代碼。

（2）接口測試定義

 

測試金字塔

接口測試是測試系統組件間接口的一種測試。

接口測試主要用於檢測外部系統與系統之間以及內部各個子系統之間的交互點。測試的重點是要檢查數據的交換，傳遞和控制管理過程，以及系統間的相互邏輯依賴關係等。
——《百度百科》

3、 接口工具對比

（1）指數對比

百度搜索指數

能夠看到近1年裏，你們對於Postman的關注度一直很高，最近幾個月的漲幅更高了。

（2） 競品對比

 

競品對比，Postman在同類競品中，並非那麼全面的，但爲何還有辣麼多人用呢？咱們往下看。

（3） Postman具體優點

總結的幾點參考優點。

1. 簡潔性：軟件界面設計簡潔有設計感；

2. 易用性：容易上手，查看官方文檔或搜搜博客，能夠很快地掌握其用法；

3. 實用性：能夠快速進行開發調試，並展現響應結果， URL 建立簡單，且方便查看與管理；

4. 同步性：同步並備份帳號數據（集合、文件夾、要求、迴應、標題預設、環境、環境變量、全局變量、收集運行結果）。

4、 Postman入門

（1）安裝

 

4.1.1  Postman：

可用做Mac，Windows和Linux操做系統的本地應用程序。

要安裝Postman，請轉至官網，而後單擊下載適用於Mac / Windows / Linux的客戶端。

安裝過程沒有特別須要說明的，具體安裝步驟不贅述，詳情查看官網。

 

4.1.2. Postman Chrome插件：

目前推薦客戶端，因爲Chrome插件已被棄用，但插件還能夠繼續運行，且只能在Chrome瀏覽器上運行。

（2） 界面設計

 

1. Header toolbar 標題欄即頂部工具欄，包含主要功能。
2. Sidebar 側邊欄能夠查找、管理請求和集合。側邊欄分兩個主要選項卡： History（歷史記錄）和 Collections（集合）。
3. Builder 構建器，在構建器中發送和管理API請求。上半部分是請求構建器，下半部分是響應查看器。
4. Status bar 狀態欄在底部，提供了部分功能的快捷方式。

 

想了解更多能夠查看Postman官方文檔。

（3） How to work

官網示意圖

1. 在Postman中輸入您的請求詳細信息（URL :），注意請求方法【get】，而後點擊發送【發送】按鈕；

 

      輸入URL地址

2. 該請求由API服務器接收，而且它返回一個響應；

3. Postman收到回覆，並在界面中顯示回覆。

 

      顯示回覆

       注：

1. 上圖接口是Postman的示例接口，參數就帶在地址的後面以‘？’鏈接，響應結果可切換顯示方式。
2. 點擊上圖【JSON】能夠選擇其餘顯示模式。

5、 實踐思考

5.1 接口項目實踐思路

1. 測試接口文檔

檢驗接口文檔的完整性、正確性、一致性、易理解性和易瀏覽性。

這個通常在實際測試過程當中，都會弱化測試，不注重。

2. 編寫測試用例

這個你們都熟，根據接口文檔編寫測試用例。用例編寫方法能夠按照黑盒測試的用例編寫規則來編寫，如：邊界值、正交表等等設計方法。

3. 執行測試並出報告

根據用例執行測試，注意驗證預期結果，執行結束後出具測試報告。

4. 持續集成測試

搭建持續集成自動化測試框架。

5.2 接口文檔

內部培訓時用的是公司內部的文檔，如今只能換開放API。

接口文檔某個接口通常包括：

1. 1. 接口功能
   2. 請求方式
   3. 入參
   4. 出參
   5. 示例

       如圖：

豆瓣搜索圖書接口

此豆瓣開發者API連接：https://developers.douban.com/wiki/?title=book_v2#get_book

5.2.1 步驟1

使用Postman工具發送該Get請求，依據3.3節操做，如圖：

 

搜索軟件測試

5.2.2 步驟2

添加測試代碼：

1. 1. status code等於200
   2. Response body中包含字符串「軟件測試」

注：測試代碼能夠依狀況本身加，因此我加了。

 

測試斷言

這裏我另加了測試「響應時間小於200ms」，看到響應超過了200ms，是720ms。

再注：Postman有不少實例能夠查看

 

實例

5.3 集成測試

       主要是利用postman出的插件Newman：

 

Newman

上圖爲官網截圖，介紹的主要意思就是藉助Newman，能夠將Postman集合與構建系統集成在一塊兒。而咱們用的比較多的構建就是Jenkins。Newman是一個命令行集合運行工具。

下圖爲集成測試示意圖：

 

        集成測試

5.3.1 步驟1

搭建環境：

安裝Node.js（Newman基於Node.js），安裝Newman （參閱Newman官網），安裝Jenkins（自行搜索安裝過程）。

5.3.2 步驟2

導出集合：

1. 先保存

         保存接口

2. 再導出

   
   
    

   

   導出1

 

       導出2

       我導出保存到了桌面，是一個json集合。

5.3.3 步驟3

經過Jenkins 構建時調用Newman，來執行接口測試。

構建的命令：

C:\Users\yawa1hz1\AppData\Roaming\npm\newman -c C:\Users\yawa1hz1\Desktop\test.postman_collection.json 

 

構建命令

選擇構建的方式Execute Windows batch command，即批處理命令。新建Jenkins項目選自由項目，其餘除必填項，均可以無論。

注：這段命令直接運行與window的cmd也是能夠的。詳細Newman命令參見官網。

新建任務完成後，執行構建

 

構建

可在 [Console Output]查看，但因爲網頁編碼格式不一樣，顯示亂碼，可點擊[View as plain text]查看，如圖

 

 

構建結果亂碼

能夠看到構建失敗（因爲某個斷言failed），和亂碼（網頁編碼格式不一樣）。

 

結果查看

能夠看到，我新加的「響應時間小於200ms」測試沒經過，因此構建失敗了。看官能夠試試更改「響應時間小於1000ms」，應該就能夠構建成功，斷言無failed了。

6、 總結

Postman還有不少功能，像 Runner 功能，目前只是介紹了基礎使用，更多操做能夠閱讀官方文檔。還有一點須要提一下，Postman 仍是比較適合功能測試和開發調試 API 時使用。