建立測試情境

本指南說明如何建立測試情境，以依序執行多個 API 請求，並在請求之間傳遞資料。測試情境對於測試複雜工作流程至關重要，其中一個請求的輸出會作為後續請求的輸入。

前置條件

開始之前，請確保你具備：

對 Apidog 中的 API 請求有基本了解

專案中至少已設定兩個 API 端點

熟悉 JSON 資料結構

逐步指南

步驟 1：建立新的測試情境

在 Apidog 中切換到 Tests 模組

點擊 "New Test Scenario"

輸入描述性名稱（例如："Pet Store Workflow"）

點擊 Continue

步驟 2：匯入 API 端點

將游標停留在 Add Step 上

選擇 "Import from endpoint case"

選擇你想要依序測試的端點

步驟 3：選擇特定測試案例

依序選擇下列案例：

Add a new pet to the store (Success)

Find pet by ID (Pets sold)

步驟 4：設定請求之間的資料傳遞

點擊 Find pet by ID (Pets sold)

在 Path params 中找到 petId 參數

刪除現有值

點擊 Magic Wand 圖示

步驟 5：使用 JSONPath 擷取資料

選擇 "Retrieve pre-step data"

選擇前一個步驟：Add a new pet to the store (Success)

點擊 JSONPath Extraction Tool 圖示

步驟 6：定義 JSONPath 運算式

在 JSONPath Extraction Tool 中：

左側顯示前一個請求的回應

右側顯示擷取結果

輸入運算式：$.data.id

確認擷取結果符合預期的 pet ID

步驟 7：套用資料擷取

在 Retrieve pre-step data 對話框中點擊 Insert

該運算式將填入 petId 參數欄位

步驟 8：執行測試情境

點擊右上角的 Save

將環境設定為 Local mock

點擊 Run 以執行情境

步驟 9：檢閱測試結果

檢查測試報告

展開每個步驟以查看請求/回應詳細資訊

確認第二個請求中的 petId 與第一個請求回傳的 ID 相符

有效測試情境的提示

從簡單開始：先從 2-3 個請求開始，再建立複雜情境

使用描述性名稱：清楚命名你的測試情境（例如："User Registration Flow"）

驗證資料：務必確認擷取的資料符合預期值

環境管理：在不同環境中測試（Local、Staging、Production）

文件說明：新增註解以說明複雜的資料傳遞邏輯

下一步

發布 API 文件

前置條件#

逐步指南#

步驟 1：建立新的測試情境#

步驟 2：匯入 API 端點#

步驟 3：選擇特定測試案例#

步驟 4：設定請求之間的資料傳遞#

步驟 5：使用 JSONPath 擷取資料#

步驟 6：定義 JSONPath 運算式#

步驟 7：套用資料擷取#

步驟 8：執行測試情境#

步驟 9：檢閱測試結果#

有效測試情境的提示#