api-testing-patterns

api-testing-patterns 技能為分散式系統與微服務提供了一套標準化的品質工程框架。它專為軟體工程師、QA 自動化專家及 DevOps 團隊設計，旨在確保服務間的穩健溝通，並減少對脆弱的「實作相依型測試」之依賴。透過將 API 視為明確的合約，本技能協助團隊識別合約測試、元件測試及整合測試，以達到速度與可靠性的平衡。

• 消費者驅動的合約測試：實作 Pact 或 Spring Cloud Contract 模式，確保服務提供者滿足消費者需求，從而提早防止開發生命週期中的破壞性變更。

• REST 與 GraphQL 生命週期測試：執行針對 CRUD 作業、分頁、篩選、結構驗證及 GraphQL 複雜度限制的結構化測試。

• 進階場景驗證：涵蓋驗證（401/403）、輸入驗證（400）、優雅錯誤處理（500）、冪等性金鑰管理及併發競態條件的測試場景。

• 效能與整合：提供使用 k6、Artillery 或 JMeter 對關鍵端點進行負載測試的工具，以及針對真實相依性的整合測試策略。

• CI/CD 與品質門檻：將結構驗證與合約檢查直接嵌入 CI 管線的實踐，實現自動化與持續性的品質保證。

• 當您需要建構新的 API 測試策略或重構現有測試以擺脫對實作的依賴時，請使用此技能。

• 常見輸入包含 API 規格書（OpenAPI/Swagger）、端點文件或服務合約；輸出包含經驗證的測試套件、覆蓋率報告及合約偏移（drift）分析。

• 測試時應優先從消費者的視角出發，避免對額外欄位或不穩定的回應資料進行斷言，以維護測試穩定性。

• 可與 qe-api-contract-validator 代理程式整合以偵測自動偏移，並透過 qe-test-generator 根據既有定義快速建立測試套件。

• 針對微服務，優先考慮使用 Mock 進行元件級隔離，僅針對需要真實環境模擬的複雜關鍵相依性進行整合測試。