API 測試入門:用 Postman 和 pytest 打造你的第一個 API 測試
API 測試是現代 QA 必備技能。從 HTTP 基礎概念到實際用 Postman 和 pytest 寫測試,帶你踏出 API 測試的第一步。
마지막 업데이트: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 是否符合規格
-
欄位驗證
必要欄位是否存在、資料型別是否正確
-
錯誤處理
是否回傳有意義的錯誤訊息
-
認證授權
認證和授權機制是否正常
-
效能
回應時間是否在可接受範圍內
관련 게으른 가방
2026년 QA 트렌드: AI 테스트, Shift-Left 및 새로운 경력 방향
AI 지원 테스트, Shift-Left 전략, QA 엔지니어의 경력 전환 방향 등 QA 분야의 최신 동향을 살펴보세요.
CI/CD의 테스트 전략: 모든 배포에 대한 품질 보장
CI/CD 파이프라인에서 테스트 전략을 계획하는 방법, 커밋부터 배포까지 각 단계에서 어떤 테스트를 실행해야 하는지, 품질 수준을 설정하는 방법을 공유하세요.
QA 경력 개발 청사진: 주니어에서 리드까지의 완전한 경로
QA 경력에는 한 가지 경로만 있는 것이 아닙니다. 주니어 QA부터 QA 리드까지 각 단계의 역량 요구 사항과 혁신 옵션을 공유하세요.
요설
본 사이트에 제공된 정보는 참고용일 뿐이며 그 완전성과 정확성을 보장하지 않습니다. 사용자는 정보의 적용 가능성에 대해 스스로 판단해야 합니다.