API測試之Postman使用全指南（一）

Postman

Postman是一個可擴展的API開發和測試協同平臺工具，可以快速集成到CI/CD管道中。旨在簡化測試和開發中的API工作流。

Postman 工具有 Chrome 擴展和獨立客戶端，推薦安裝獨立客戶端。

Postman 有個 workspace 的概念，workspace 分 personal 和 team 類型。Personal workspace 只能自己查看的 API，Team workspace 可添加成員和設置成員權限，成員之間可共同管理 API。

當然我個人使用一般是不登錄的，因爲登錄之後會自動將你的測試歷史數據保存到賬戶裏，你可以登陸網頁端進行查看。
因爲API的很多數據是很敏感的，有的含有Token，或者就是一些私密信息，雖然Postman自己也強調說這樣很安全，不會私下窺探用戶的信息之類的，但是呢還是至少做一點有效的防範吧，自己不上傳，因爲網絡並沒有絕對的安全。
所以我每次測試之後會將數據(Case)保存在本地，下次使用或者換設備的情況下將數據拷貝過來又可以繼續使用了。

下面正式開始介紹如何使用Postman吧。

爲什麼選擇Postman?

如今，Postman的開發者已超過1000萬(來自官網)，選擇使用Postman的原因如下:
簡單易用 - 要使用Postman，你只需登錄自己的賬戶，只要在電腦上安裝了Postman應用程序，就可以方便地隨時隨地訪問文件。
使用集合 - Postman允許用戶爲他們的API調用創建集合。每個集合可以創建子文件夾和多個請求。這有助於組織測試結構。
多人協作 - 可以導入或導出集合和環境，從而方便共享文件。直接使用鏈接還可以用於共享集合。
創建環境 - 創建多個環境有助於減少測試重複(DEV/QA/STG/UAT/PROD)，因爲可以爲不同的環境使用相同的集合。這是參數化發生的地方，將在後續介紹。
創建測試 - 測試檢查點(如驗證HTTP響應狀態是否成功)可以添加到每個API調用中，這有助於確保測試覆蓋率。
自動化測試 - 通過使用集合Runner或Newman，可以在多個迭代中運行測試，節省了重複測試的時間。
調試 - Postman控制檯有助於檢查已檢索到的數據，從而易於調試測試。
持續集成——通過其支持持續集成的能力，可以維護開發實踐。

如何下載安裝Postman？

Step 1）官網主頁：https://www.postman.com/downloads/，下載所需版本進行安裝即可。

Step2）安裝完成之後會要求你必須登錄才能使用，沒有賬號可以進行註冊，註冊是免費的。(也可使用Google賬號，不過基本不能登錄，你懂的)

Step3）在Workspace選擇你要使用的工具並點擊“Save My Preferences”保存。

Step4）你將看到啓動後的頁面如下

如何使用Postman?

下圖是Postman的工作區間，各個模塊功能的介紹如下：

1、New，在這裏創建新的請求、集合或環境；還可以創建更高級的文檔、Mock Server 和 Monitor以及API。
2、Import，這用於導入集合或環境。有一些選項，例如從文件，文件夾導入，鏈接或粘貼原始文本。
3、Runner，可以通過Collection Runner執行自動化測試。後續介紹。
4、Open New，打開一個新的標籤，Postman窗口或Runner窗口。
5、My Workspace - 可以單獨或以團隊的形式創建新的工作區。
6、Invite - 通過邀請團隊成員在工作空間上進行協同工作。
7、History - 所有請求的歷史記錄，這樣可以很容易地跟蹤你所做的操作。
8、Collections - 通過創建集合來組織你的測試套件。每個集合可能有子文件夾和多個請求。請求或文件夾也可以被複制。
9、Request tab - 這將顯示您正在處理的請求的標題。默認對於沒有標題的請求會顯示“Untitled Request”。
10、HTTP Request - 單擊它將顯示不同請求的下拉列表，例如 GET, POST, COPY, DELETE, etc. 在測試中，最常用的請求是GET和POST。
11、Request URL - 也稱爲端點，顯示API的URL。.
12、Save - 如果對請求進行了更改，必須單擊save，這樣新更改纔不會丟失或覆蓋。
13、Params - 在這裏將編寫請求所需的參數，比如Key - Value。
14、Authorization - 爲了訪問api，需要適當的授權。它可以是Username、Password、Token等形式。
15、Headers - 請求頭信息
16、Body - 請求體信息，一般在POST中才會使用到
17、Pre-request Script - 請求之前先執行腳本，使用設置環境的預請求腳本來確保在正確的環境中運行測試。
18、Tests - 這些腳本是在請求期間執行的。進行測試非常重要，因爲它設置檢查點來驗證響應狀態是否正常、檢索的數據是否符合預期以及其他測試。
19、Settings - 最新版本的有設置，一般用不到。

如何處理GET請求

Get請求用於從指定的URL獲取信息，不會對端點進行任何更改。
在這裏我們使用如下的URL作爲演示：

https://jsonplaceholder.typicode.com/users

在Postman的工作區中：
1、選擇HTTP請求方式爲GET
2、在URL區域輸入鏈接
3、點擊 “Send”按鈕
4、你將看到下方返回200狀態碼
5、在正文中應該有10個用戶結果，表明您的測試已經成功運行。

**注意：**在某些情況下，Get請求失敗可能由於URL無效或需要身份驗證。

如何處理POST請求

Post請求與Get請求不同，因爲存在用戶向端點添加數據的數據操作。使用之前GET 請求中相同數據，現在添加我們自己的用戶。
Step 1）創建一個新請求

Step 2 ）在新請求中
1、選擇HTTP請求方式爲GET
2、在URL區域輸入鏈接：https://jsonplaceholder.typicode.com/users
3、切換到Body選項

Step 3）Body選項
1、選中raw選項
2、選擇JSON

Step 4）複製前面GET請求返回的json內容的第一節
更改id爲11，更改name以及uesrname和email

[
    {
        "id": 11,
        "name": "Krishna Rungta",
        "username": "Bret",
        "email": "[email protected]
  ",
        "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格式很重要，以確保數據正確。
檢測的工具比如：https://jsonformatter.curiousconcept.com/

Step 5 ）發送請求
1、完成上述的信息輸入，點擊Send按鈕
2、Status:應該是201，顯示爲創建成功
3、在Body裏返回數據