Mocking API：概覽

API Mocking 是建立模擬 API 回應以模仿真實 API 行為的做法。您不呼叫實際的 API，而是使用 Mock 伺服器根據您的 API 規範返回逼真的測試資料。

本章將教您如何使用 Apidog 強大的 Mock 功能來為開發、測試和協作場景建立 Mock API。在整章中，我們將使用 Pet Store API 作為範例——一個簡單的寵物管理系統，展示常見的 API Mock 使用案例。

何時需要 Mocking？

API Mocking 在幾個常見場景中至關重要：

1. 前端和後端平行開發

當 API 規範已準備好 但 後端 API 尚未實作 時，前端開發人員可以使用 Mock 資料繼續開發而無需等待。這使團隊能夠平行工作，顯著加快開發過程。

範例：前端團隊收到新功能的 OpenAPI 規範。當後端團隊仍在實作時，前端團隊可以使用 Mock API 構建和測試 UI。

2. 使用生產資料

當實際 API 包含 敏感生產資料 或您希望避免在開發期間進行真實 API 呼叫時，Mock 資料提供了安全的替代方案。這保護了生產系統並防止意外的資料修改。

範例：您正在開發一個與支付 API 互動的功能。您不冒險進行真實交易，而是使用模擬支付回應的 Mock 資料。

3. 測試和 QA

在測試期間，您通常需要 可預測、可控制的測試資料，涵蓋各種場景（成功案例、錯誤案例、邊緣案例）。Mock API 允許您生成一致的測試資料集，而不依賴外部服務。

範例：您需要測試應用程式如何處理不同的回應狀態碼 (200, 404, 500)。Mock API 讓您可以可靠地模擬這些場景。

4. 外部 API 依賴

當您的應用程式依賴 第三方 API，而這些 API：

不可用或不可靠

有速率限制或呼叫成本昂貴

難以在測試環境中設定

Mock API 為開發和測試提供了穩定、始終可用的替代方案。

5. API 設計和文件

當 設計新 API 時，您可以建立 Mock 回應來演示 API 在實作之前將如何運作。這有助於利害關係人視覺化 API 並提供早期反饋。

範例：您正在設計一個新的使用者管理 API。建立 Mock 回應有助於團隊在開始編碼之前了解資料結構並驗證設計。

您將學到什麼

在本章中，您將了解 Apidog 全面的 Mock 功能：

Smart Mock — 基於您的 API 規範自動生成 Mock 資料，使用智慧名稱匹配和 JSON Schema 約束。

Mock Expectations — 建立帶有條件的自訂 Mock 回應，允許根據請求參數、標頭或 Body 內容做出不同回應。

Cloud Mock — 在雲端部署 Mock 伺服器以供團隊範圍存取，實現無需本地依賴的協作和整合測試。

Mock Scripts — 使用 JavaScript 建立動態 Mock 回應，保持請求和回應資料之間的邏輯關係。

Apidog Mocking 如何運作

Apidog 提供高效的 Mock 引擎，根據您的 API 規範生成逼真的回應。Mock 引擎：

自動生成資料：從您的 API 規範生成，無需額外配置

遵守 JSON Schema 約束：確保有效的回應

支援多種 Mock 方法：Smart Mock、回範例、自訂 Mock

提供靈活的部署選項：本地、雲端或自託管

您可以透過以下方式存取 Mock API：

Mock URL — 直接 HTTP 請求到 Mock 端點

環境切換 — 在 Apidog 中使用本地 Mock 或雲端 Mock 環境

先決條件

在開始本章之前，您應該：

了解 API 基礎（在「API 基礎」中涵蓋）

知道如何使用 API 規範（在「Working with APIs」中涵蓋）

已安裝並設定 Apidog

已匯入 Pet Store API 規範（或知道如何匯入）

準備好開始了嗎？從 Smart Mock 開始，學習 Apidog 如何從您的 API 規範自動生成 Mock 資料。

何時需要 Mocking？#

1. 前端和後端平行開發#

2. 使用生產資料#

3. 測試和 QA#

4. 外部 API 依賴#

5. API 設計和文件#

您將學到什麼#

Apidog Mocking 如何運作#

先決條件#