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 是否符合規格
-
欄位驗證
必要欄位是否存在、資料型別是否正確
-
錯誤處理
是否回傳有意義的錯誤訊息
-
認證授權
認證和授權機制是否正常
-
效能
回應時間是否在可接受範圍內
相關懶人包
Comment rédiger un cas de test de manière professionnelle ? Démontage complet des exigences aux cas de test
De bons cas de test sont l’arme principale du contrôle qualité. Partagez une approche systématique allant de l'analyse des exigences à la rédaction de cas de test, y compris des techniques pratiques telles que la segmentation équivalente et l'analyse des valeurs limites.
L'art du rapport de bogues : comment rédiger des rapports de bogues que les développeurs peuvent comprendre en quelques secondes
Un bon rapport de bug peut considérablement accélérer le processus de réparation. Partagez les meilleures pratiques en matière de signalement de bogues, notamment les modèles, les évaluations de gravité et la manière de communiquer efficacement avec les développeurs.
La boîte à outils de l'ingénieur QA : outils de test essentiels recommandés pour 2026
Organise les outils de test couramment utilisés par les ingénieurs QA dans leur travail quotidien, de la gestion des tests, du cadre d'automatisation à la surveillance des performances, avec une expérience d'utilisation et des suggestions de sélection.
Déclaration générale
Les informations fournies sur ce site sont fournies à titre indicatif uniquement et leur exhaustivité et leur exactitude ne sont pas garanties. Les utilisateurs doivent porter leur propre jugement sur l'applicabilité des informations.