如何在Ubuntu上用Postman測試RESTful API

一、在Ubuntu上安裝Postman

Postman支持多種安裝方式，以下是推薦的三種方法：

1. 通過Snap安裝（最簡方式）

Snap是Ubuntu官方軟件包管理工具，安裝Postman只需兩步：

• 打開終端，運行以下命令添加Postman的Snap倉庫并安裝：

  sudo snap install postman --classic
  

  --classic參數允許Postman以經典模式運行（無需沙盒限制）。安裝完成后，直接在終端輸入postman即可啟動應用。

2. 手動下載安裝包（靈活控制版本）

若需使用特定版本的Postman，可通過以下步驟手動安裝：

• 訪問Postman官網（dl.pstmn.io），下載最新的Linux安裝包（如Postman-linux-x64-10.24.0.tar.gz）。
• 打開終端，進入下載目錄，解壓安裝包到/opt目錄（系統級軟件存放路徑）：

  cd ~/Downloads
  sudo tar -xzf Postman-linux-x64-*.tar.gz -C /opt/
  

• 創建全局符號鏈接，方便在終端直接調用Postman：

  sudo ln -s /opt/Postman/Postman /usr/local/bin/postman
  

• （可選）創建桌面快捷方式，方便通過應用菜單啟動：

  sudo nano /usr/share/applications/postman.desktop
  

  粘貼以下內容（修改Exec路徑為實際解壓路徑）：

  [Desktop Entry]
  Encoding=UTF-8
  Name=Postman
  Exec=/opt/Postman/Postman
  Icon=/opt/Postman/app/resources/app/assets/icon.png
  Terminal=false
  Type=Application
  Categories=Development;
  

  保存后運行sudo update-desktop-database更新桌面啟動器。

3. 通過APT倉庫安裝（適合習慣APT的用戶）

若系統已添加Postman的官方PPA，可通過APT安裝：

• 更新系統并添加PPA：

  sudo apt update
  sudo add-apt-repository https://dl.bintray.com/postman/apt
  sudo apt update
  

• 安裝Postman：

  sudo apt install postman
  

  安裝完成后，通過終端輸入postman啟動。

二、使用Postman測試RESTful API

安裝完成后，即可通過Postman發送請求并測試API。以下是核心操作流程：

1. 創建新請求

• 打開Postman，點擊左上角**+ New按鈕，選擇HTTP Request**（或直接點擊左側“Collections”旁的“+”）。
• 輸入請求名稱（如“Get User Info”），選擇請求方法（GET、POST、PUT、DELETE等），并在URL欄輸入目標API地址（如https://api.github.com/users/octocat）。

2. 配置請求參數與頭部

• 查詢參數（Query Params）：點擊Params標簽，輸入鍵值對（如sort=created），Postman會自動將其拼接到URL末尾（如https://api.github.com/users/octocat?sort=created）。
• 請求頭（Headers）：點擊Headers標簽，添加必要的頭部信息（如Accept: application/json，用于指定響應格式為JSON）。

3. 發送請求并查看響應

• 確認配置無誤后，點擊右上角Send按鈕。Postman會在下方Response區域顯示結果：
  • 狀態碼（如200表示成功，404表示未找到資源）；
  • 響應時間（如350ms）；
  • 響應體（默認以“Pretty”格式展示JSON，可切換為“Raw”查看原始數據）；
  • 響應頭（如Content-Type: application/json）。

4. 添加測試斷言（驗證響應）

• 切換到Tests標簽，編寫JavaScript測試腳本，驗證響應是否符合預期。常見斷言示例：

  // 驗證狀態碼為200
  pm.test("Status code is 200", function () {
    pm.response.to.have.status(200);
  });
  
  // 驗證響應時間小于500ms
  pm.test("Response time is less than 500ms", function () {
    pm.expect(pm.response.responseTime).to.be.below(500);
  });
  
  // 驗證響應體包含“login”字段
  pm.test("Response has 'login' field", function () {
    pm.response.to.have.jsonBody('login');
  });
  

  發送請求后，Test Results面板會顯示斷言結果（綠色為通過，紅色為失?。?。

5. 管理請求集合（批量測試）

• 將常用請求保存為集合，方便批量管理和執行：
  • 點擊左側“Collections”旁的“+”，輸入集合名稱（如“Demo API Tests”），點擊“Create”。
  • 將請求拖拽至集合中，或點擊請求編輯區的“Save”按鈕選擇集合。
• 批量運行集合：右鍵集合→Run Collection，在“Collection Runner”中設置迭代次數、延遲時間，點擊“Run”即可執行集合中所有請求，并生成匯總報告（如通過率、平均響應時間）。

三、進階技巧（可選）

1. 使用環境變量（動態配置）

若需在不同環境（開發、測試、生產）間切換，可創建環境變量：

• 點擊Postman頂部菜單Manage Environments→Add，輸入環境名稱（如“Development”），添加變量（如baseUrl: https://api-dev.example.com）。
• 在請求中使用變量：將URL中的動態部分替換為{{變量名}}（如{{baseUrl}}/users/octocat）。發送請求時，Postman會自動替換變量值。

2. 自動化測試（Newman工具）

Postman的命令行工具Newman可將測試集成到CI/CD流程中：

• 安裝Newman：

  npm install -g newman
  

• 導出集合：在Postman中右鍵集合→Export，選擇“Collection v2.1”格式，保存為collection.json。
• 運行測試：

  newman run collection.json --environment environment.json
  

  其中environment.json是環境變量文件（可選）。Newman會輸出測試結果，并支持生成HTML報告（如newman run collection.json --reporters html）。

通過以上步驟，即可在Ubuntu上使用Postman完成RESTful API的測試，涵蓋從基礎請求到自動化測試的全流程。