九號工具站
返回列表

API 測試入門:用 Postman 和 pytest 打造你的第一個 API 測試

API 測試是現代 QA 必備技能。從 HTTP 基礎概念到實際用 Postman 和 pytest 寫測試,帶你踏出 API 測試的第一步。

QA API 測試 Postman pytest HTTP 自動化測試

最後更新:2026-03-07

本文範例使用假設的 API 端點,實際測試時請替換為你的目標 API。

1. 為什麼要學 API 測試?

比起 UI 測試,API 測試有幾個明顯優勢:

  • 更快

    不需要等頁面載入,直接測後端邏輯

  • 更穩定

    不受 UI 改版影響

  • 更早測

    前端還沒做好就能測後端

  • 更容易自動化

    純資料交換,不需要處理 UI 元素

2. HTTP 基礎快速複習

API 測試前,先搞懂 HTTP 方法:GET(取得資料)、POST(新增資料)、PUT/PATCH(更新資料)、DELETE(刪除資料)。常見的回應狀態碼:200 成功、201 建立成功、400 請求格式錯誤、401 未認證、403 沒有權限、404 找不到資源、500 伺服器錯誤。

3. 用 Postman 開始測試

Postman 是最友善的 API 測試工具:

  • 建立 Collection

    把相關 API 分組管理

  • 設定環境變數

    dev / staging / production 切換

  • 寫測試腳本

    在 Tests tab 用 JavaScript 驗證回應

  • 用 Runner 批次執行

    一次跑完所有測試案例

4. 用 pytest 寫 API 測試

當你需要更強大的自動化能力時,用 Python + pytest + requests。可以測試 GET 取得資料、POST 建立資料、以及各種錯誤處理場景。pytest 的 assert 語法直覺好讀,搭配 parametrize 可以輕鬆測試多組資料。

5. API 測試檢查清單

確保你的 API 測試涵蓋以下面向:

  • 狀態碼驗證

    確認回應的 HTTP 狀態碼正確

  • 回應格式

    JSON schema 是否符合規格

  • 欄位驗證

    必要欄位是否存在、資料型別是否正確

  • 錯誤處理

    是否回傳有意義的錯誤訊息

  • 認證授權

    認證和授權機制是否正常

  • 效能

    回應時間是否在可接受範圍內

ℹ️

一般聲明

本站提供之資訊僅供參考,不保證其完整性與正確性。使用者應自行判斷資訊之適用性。

意見反饋