測試案例

從 Apidog 版本 2.7.29 開始，你現在可以直接在端點詳情頁面新增測試案例。

每個測試案例代表該端點的一組請求參數。使用者可以有系統地組織和管理所有測試案例，然後一鍵執行它們，以完成目前端點的測試。

測試案例 vs. 偵錯案例

測試案例

目的： 驗證端點在不同請求情境下是否如預期運作，著重於完整性。

涵蓋廣泛的情境： 正向、負向、邊界和安全性。

通常較少修改或執行。

偵錯案例

目的： 在開發或疑難排解期間快速驗證端點回應，著重於速度。

通常限於成功和失敗等基本情境。

經常修改並頻繁執行。

建立測試案例

你可以透過幾種方式建立測試案例：

1. 手動建立

在端點詳情頁面的 Test Cases 分頁中，點擊 + Add Case 以手動建立一個案例。

2. 從偵錯案例匯入

新增測試案例時，你可以選擇 Import from Debug Cases，將現有的偵錯案例複製或移動到測試案例中。

複製：當你仍需要該偵錯案例進行快速驗證，但也希望將其作為測試案例時使用。

移動：當該偵錯案例不再頻繁用於偵錯，且主要是為了測試例外情況而撰寫時使用。這會直接將其轉換為測試案例；如果測試案例原本是以偵錯案例建立的，這能讓遷移更快速。

測試案例詳情

測試案例包含以下資訊：

群組： 依測試目的組織（正向、負向、邊界等）。

案例名稱： 測試案例的名稱。

請求參數： Path、Query、Header 和 form-data Body 參數。

請求主體： 支援 RAW、JSON、XML 等。

前置/後置處理器

回應驗證： 啟用/停用驗證，並指定要驗證的回應組件。

[!NOTE]
由於測試案例較少更新，因此必須手動與端點變更同步。例如，如果端點新增了一個欄位，你需要在測試案例中點擊 Update 來更新它。

任何對測試案例詳情的編輯，都必須點擊 Save 才會儲存。如果有未儲存的變更，系統會提示你。

管理測試案例

在 Test Cases 分頁中，你可以管理所有已建立的測試案例。使用左上角的搜尋和篩選功能，可以輕鬆找到你需要的測試案例。你也可以使用群組分頁，依群組快速查看測試案例。針對特定測試案例的操作：

單一測試案例： 你可以開啟新分頁來查看、修改和執行測試案例。基本操作包括複製、將測試案例移動到其他群組、複製測試案例的 cURL，以及刪除測試案例。

多個測試案例： 當你在列表中選取多個測試案例時，右上角會出現操作按鈕，讓你可以批次分組、刪除，以及與端點更新同步。

執行測試案例

查看測試案例時，點擊 Run 按鈕以使用其參數傳送請求。接著會顯示實際回應。

你也可以使用 Run All，或從列表中選取多個測試案例並一起執行。介面會顯示哪些案例正在執行，以及哪些已有結果。

批次執行後，你可以開啟測試案例，直接查看其執行結果。

測試報告

批次執行測試後，你可以在右上角的 Test Reports 中查看所有歷史報告。

點擊報告即可查看詳細結果，協助進行問題追蹤和分析。

測試案例運作方式概覽：

單一端點測試的最佳實務

單一端點測試通常涉及兩種角色：後端開發人員和 QA 工程師。

後端開發人員： 撰寫並偵錯端點程式碼。

QA 工程師： 執行全面的 API 測試並找出問題。

隨著 Apidog 現在支援端點的測試案例，工作流程可以更有效率：

QA 工程師可以直接在端點文件中撰寫和管理單元測試案例。

開發人員可以使用現有測試案例來執行測試、查看結果並自行修復問題——無需等待 QA 工程師回饋或冗長溝通。

最佳實務工作流程：

此工作流程可以提升協作效率：

測試案例可以在端點文件定稿後立即撰寫，並在 Apidog 中對所有團隊成員可見。

開發人員可以在偵錯後自行測試端點——無需等待 QA 工程師。

開發人員可以根據測試結果直接修復問題——不需要額外的票證或交接。

清楚的測試結果能讓問題說明更直接，避免溝通誤解。

建立測試案例#

1. 手動建立#

2. 從偵錯案例匯入#

測試案例詳情#

管理測試案例#

執行測試案例#

測試報告#

單一端點測試的最佳實務#