Apidog Docs
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
🇨🇳 繁體中文
  • 🇺🇸 English
  • 🇯🇵 日本語
  • 🇪🇸 Español
  • 🇰🇷 한국인
  • 🇨🇳 简体中文
  • 🇵🇹 Português (Portugal)
  • 🇮🇩 Bahasa Indonesia
  • 🇧🇷 Português (Brasil)
  • 🇻🇳 Tiếng Việt
  • 🇨🇳 繁體中文
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
HomeLearning Center
Support CenterAPI ReferencesDownloadChangelog
  1. 測試情境
  • Apidog 學習中心
  • 開始使用
    • Apidog 簡介
    • Apidog 中的基本概念
    • 導覽 Apidog
    • 快速開始
      • 概覽
      • 建立端點
      • 發送請求
      • 新增斷言
      • 建立測試情境
      • 分享 API 文件
      • 探索更多
    • 遷移到 Apidog
      • 概覽
      • 手動匯入
      • 排程匯入(綁定資料來源)
      • 匯入選項
      • 匯出資料
      • 匯入自
        • 從 Postman 匯入
        • 匯入 OpenAPI 規格
        • 匯入 cURL
        • 匯入 Markdown
        • 從 Insomnia 匯入
        • 從 apiDoc 匯入
        • 匯入 .har 檔案
        • 匯入 WSDL
  • Mock API 資料
    • 概述
    • Smart Mock
    • 自訂模擬
    • 模擬優先順序
    • 模擬腳本
    • 雲端模擬
    • 自託管 Runner 模擬
    • 模擬語言(Locales)
  • 帳號與偏好設定
    • 帳戶設定
    • 產生 OpenAPI 存取權杖
    • 通知
    • 語言設定
    • 快捷鍵
    • 網路代理設定
    • 備份資料
    • 更新 Apidog
    • 刪除帳戶
    • 實驗性功能
  • 傳送請求
    • 概覽
    • SSE 偵錯
    • MCP Client
    • Socket.IO
    • WebSocket
    • Webhook
    • SOAP 或 WebService
    • GraphQL
    • gRPC
    • 使用請求代理代理程式進行偵錯
    • 建立請求
      • 請求歷史記錄
      • 請求基礎
      • 參數與主體
      • 請求標頭
      • 請求設定
      • 偵錯請求
      • 將請求儲存為端點
      • HTTP/2
    • 驗證與授權
      • 概覽
      • CA 和用戶端憑證
      • 授權類型
      • Digest Auth
      • OAuth 1.0
      • OAuth 2.0
      • Hawk 驗證
      • Kerberos
      • NTLM
      • Akamai EdgeGrid
    • 回應和 Cookie
      • 檢視 API 回應
      • 管理 Cookie
      • 概覽
  • 開發和偵錯 API
    • 概觀
    • 產生請求
    • 傳送請求
    • 偵錯案例
    • 測試案例
    • 動態值
    • 驗證回應
    • Design-First 與 Request-First
    • 產生程式碼
    • 環境與變數
      • 概述
      • 使用變數
      • 環境管理
    • Vault 密鑰
      • 概覽
      • HashiCorp Vault
      • Azure Key Vault
      • AWS Secrets Manager
    • 動態值模組
      • Airline
      • 動物
      • 顏色
      • Commerce
      • Company
      • 資料庫
      • Datatype
      • 日期
      • Finance
      • Food
      • Git
      • Hacker
      • Helpers
      • 圖片
      • Internet
      • 位置
      • Lorem
      • 音樂
      • Number
      • Person
      • Phone
      • 科學
      • 字串
      • System
      • Vehicle
      • Word
    • 前置和後置處理器
      • 概覽
      • 斷言
      • 擷取變數
      • Wait
      • 安全性
      • 資料庫操作
        • 概述
        • MySQL
        • MongoDB
        • Redis
        • Oracle Client
      • 使用腳本
        • 概觀
        • 前置處理器指令碼
        • 後置處理器腳本
        • 公開腳本
        • Postman Scripts Reference
        • 呼叫其他程式語言
        • 使用 JS Libraries
        • 視覺化回應
        • 腳本範例
          • 斷言腳本
          • 使用變數
          • 修改請求
          • 其他範例
    • API 偵錯
      • AI Agent Debugger
      • A2A Debugger
  • 設計 API
    • 概覽
    • 建立新的 API 專案
    • 端點基礎
    • APl 設計指南
    • 模組
    • 設定多個請求主體範例
    • 元件
    • 通用欄位
    • 全域參數
    • 端點變更歷史
    • 留言
    • 批次端點管理
    • 自訂協定 API
    • Spec-first 模式 (Beta)
    • 安全方案
      • 概觀
      • 建立安全性方案
      • 使用 Security Scheme
      • 線上文件中的安全性方案
    • 進階功能
      • 自訂端點欄位
      • 關聯的測試場景
      • 端點狀態
      • 參數列表的外觀
      • 端點唯一識別
    • Schemas
      • 概述
      • 建立新 Schema
      • 建立 Schema
      • 從 JSON 等產生 Schema
      • oneOf, allOf, anyOf
      • 使用 Discriminator
  • API 測試
    • 概述
    • 測試情境
      • 建立測試情境
      • 在請求之間傳遞資料
      • 流程控制條件
      • 從端點和端點案例同步資料
      • 從其他專案匯入端點和端點案例
      • 匯出測試情境
    • 測試報告
      • 測試報告
    • 執行測試情境
      • 執行測試場景
      • 批次執行測試場景
      • 資料驅動測試
      • 共享測試資料
      • 排程任務
      • 管理來自其他專案的 API 執行環境
    • 測試套件
      • 概述
      • 建立測試套件
      • 編排測試套件
      • 在本機執行測試套件
      • 透過 CLI 執行測試套件
      • 排程任務
    • 測試 API
      • 整合測試
      • 效能測試
      • 端對端測試
      • 迴歸測試
      • 契約測試
    • Apidog CLI
      • 概覽
      • 安裝並執行 Apidog CLI
      • Apidog CLI 選項
    • CI/CD
      • 概述
      • 與 Github Actions 整合
      • Integrate with Gitlab
      • 與 Jenkins 整合
      • 透過 Git Commit 觸發測試
  • 發布 API 文件
    • 概述
    • 支援的 API 技術
    • 快速分享
    • 檢視 API 文件
    • Markdown 文件
    • 發佈文件網站
    • 自訂登入頁面
    • 自訂版面配置
    • 自訂 CSS、JavaScript、HTML
    • 自訂網域
    • AI Features
    • SEO 設定
    • 進階設定
      • 文件搜尋
      • CORS Proxy
      • 整合 Google Analytics
      • 資料夾樹設定
      • 可見性設定
      • 在文件 URL 中嵌入值
    • API 版本
      • 概述
      • 建立 API 版本
      • 發佈 API 版本
      • 使用 API 版本分享端點
  • 分支
    • 概觀
    • 建立 Sprint 分支
    • 在分支中測試 API
    • 在分支中設計 API
    • 合併 Sprint 分支
    • 管理 Sprint 分支
    • AI Branch (Beta)
  • AI 功能
    • 概觀
    • 啟用 AI 功能
    • 產生測試案例
    • 使用 AI 修改 Schema
    • 端點合規性檢查
    • API 文件完整性檢查
    • AI 驅動的欄位命名
    • 常見問題
  • Apidog MCP 伺服器
    • 概覽
    • 將 Apidog 專案連接至 AI
    • 將已發布的文件連接至 AI
    • 將 OpenAPI 檔案連接到 AI
  • Apidog Europe
    • Apidog Europe
  • 最佳實務
    • 處理 API 簽章
    • 存取受 OAuth 2.0 保護的 API
    • 協作工作流程
    • 管理驗證狀態
  • 離線空間
    • 概述
  • 管理
    • 管理專案
      • 管理專案
      • 通知設定
      • 管理專案成員
      • 專案資源
        • 資料庫連線
        • Git 連線
    • 管理團隊
      • 管理團隊
      • 管理團隊成員
      • 團隊活動
      • 團隊角色與權限
      • 團隊資源
        • General Runner
        • 團隊變數
        • 請求代理代理程式
      • 即時協作
        • 團隊協作
    • 入門檢查清單
      • 基本概念
      • 入門指南
    • 管理組織
      • 管理組織
      • 組織角色與權限
      • 方案管理
        • 組織中的帳單管理員
      • 單一登入 (SSO)
        • SSO 概覽
        • 設定 Microsoft Entra ID
        • 設定 Okta
        • 為組織設定 SSO
        • 管理使用者帳戶
        • 將群組對應到團隊
      • SCIM 佈建
        • SCIM 佈建簡介
        • Microsoft Entra ID
        • Okta
      • 組織資源
        • 自託管 Runner
  • 帳單
    • 概觀
    • 點數
    • 升級您的方案
    • 替代付款方式
    • 管理訂閱
    • 將付費團隊移至組織
  • 附加元件
    • API Hub
    • Apidog Intellij IDEA 外掛
    • 瀏覽器擴充功能
      • Chrome
      • Microsoft Edge
    • 請求代理
      • Web 中的請求代理
      • 共用文件中的請求代理
      • 用戶端中的請求代理
  • 資料與安全
    • 資料儲存與安全性
    • 使用者資料隱私與安全
    • 請求路由與資料安全
  • 參考
    • API 設計優先方法
    • Apidog OpenAPI 規格擴充
    • JSONPath
    • XPath
    • 正規表示式
    • JSON Schema
    • CSV 檔案格式
    • 安裝 Java 環境
    • Runner 部署環境
    • Apidog Markdown 語法
    • Apidog Swagger 擴充
      • 概述
      • x-apidog-folder
      • x-apidog-status
      • x-apidog-name
      • x-apidog-maintainer
    • Apidog JSON Schema 擴充
      • 概述
      • x-apidog-mock
      • x-apidog-orders
      • x-apidog-enum
  • 支援中心
  1. 測試情境

建立測試情境

Apidog 測試中的測試情境是基本單位,類似於 Postman 中的 Collection。當你需要連續傳送多個請求、建立連續的測試情境,或使用不同測試資料重複請求時,可以建立一個測試情境並將必要的請求加入其中。

測試情境的優點#

使用 Apidog 的測試情境,你可以有效滿足一系列 API 測試需求:
功能說明
依序執行請求依指定順序組織並執行多個請求,以模擬使用者互動或流程
測試報告自動產生報告,提供斷言與個別請求結果的詳細視覺化呈現
CI/CD 整合將測試情境整合至 CI/CD 管線,確保開發週期中的自動化測試,促進及早發現問題
效能測試在不同負載下評估 API 效能,並產生趨勢分析,以識別回應行為隨時間的變化
動態參數測試使用動態產生的參數多次執行請求,以測試 API 如何處理可變輸入
預定義測試資料對請求使用預設資料,以模擬真實操作條件,並根據預期輸出驗證 API 回應
請求之間的資料傳遞自動將一個請求的輸出資料傳遞至另一個請求,這對於測試需要跨呼叫維持狀態的 API 至關重要
邏輯請求關係設定 if、for 和 foreach 等邏輯條件,以根據先前請求的結果或特定條件管理執行流程
這些功能可讓你建立多用途且有效的測試環境,進而促進穩健且高品質的 API 開發。

建立測試情境#

開啟 Apidog 後,前往「Tests」模組,然後點擊搜尋列旁的 + 以建立新的測試情境。選擇適當的目錄,並設定優先級以完成建立。
建立新的測試情境

新增測試步驟#

在 Apidog 中設定好測試情境後,你就可以開始加入請求。有多種新增請求的方式,每種方式都適用於不同需求與彈性:

連結至端點規格的請求#

這些請求可隨端點規格變更而更新:

從端點規格匯入#

你可以將目前專案中的端點規格匯入為測試情境中的步驟。匯入端點時有兩種模式:「Manual」和「Automated」。如需更詳細的說明,請參閱從端點/端點案例同步資料。
Manual 模式
在「Manual」模式中,專案內端點文件的修改不會立即影響測試步驟中的端點。只有在測試人員啟用「Manual」按鈕時,才會同步測試資料。需要注意的是,即使點擊「Manual Sync」,對測試步驟資料所做的變更也不會更新端點文件。相反地,點擊此按鈕會讓測試情境從端點文件擷取資訊以進行同步。
Automated 模式
在「Automated」模式中,專案內端點文件的任何變更都會同步更新至測試步驟中。
Manual 和 Automated 模式
如果你需要在一個測試情境中測試其他專案的端點,請參閱將其他專案的端點/案例匯入至測試步驟。

從端點案例匯入#

你可以選擇從目前專案或其他專案匯入端點案例。匯入端點案例時有兩種模式:「Copy」 和 「Reference」。
Copy 模式
將端點案例以 「Copy」 匯入時,端點案例中的參數也會被複製到測試步驟中。它們彼此獨立,各自的變更不會影響其他項目。可以選擇手動同步。
Reference 模式
將端點案例以 「Reference」 匯入時,請求會直接使用原始專案中的端點案例。
Copy 和 Reference 模式
如果測試步驟是從案例引用而來,你會看到提示,指出修改此步驟也會影響原始端點案例以及任何其他使用該案例的步驟。
引用案例提示

未與 API 規格關聯的獨立請求#

這些請求不會因 API 規格變更而更新。它們允許更高程度的自訂:

新增自訂請求#

在工作流程中,你可能需要呼叫專案外部的端點,例如第三方付款端點。
你可以在測試步驟中新增自訂 API 請求。自訂請求可以是任何 HTTP 請求,包括常見的 GET、POST、PUT、DELETE 等。

從 cURL 新增#

在實際工作流程中,許多端點請求會以 cURL 命令列的形式呈現。你可以一鍵將 cURL 請求匯入至測試步驟。

引用其他測試情境#

包含其他測試情境的步驟#

你可以透過從同一專案中的其他測試情境匯入,複製測試步驟或流程控制條件。
包含其他情境的步驟

引用其他測試情境#

你可以將其他測試情境引用為測試步驟。有兩種使用情境:
1.
如果你的業務流程有一些通用且可重複使用的 API 測試步驟,你可以將這些步驟編排成一個小型測試情境,然後在其他更廣泛的測試情境中直接引用它。
2.
如果你需要對整個產品的主流程進行回歸測試,可以在測試情境中引用各個子測試情境進行組合,並一鍵完成所有主流程的測試回歸工作。
為了避免無限迴圈,以及測試情境無法正常停止執行的情況,引用其他測試情境的功能不能引用原始測試情境本身。

編排測試情境#

點擊任何測試步驟都會進入編排模式。在此模式中,你會有更大的操作頁面,能更好且更有效率地填寫每個測試步驟的詳細內容。頁面左側是測試情境的整體流程,右側是所選測試步驟的詳細資訊。端點請求和測試流程控制元件會有不同的顯示面板。
你可以拖曳步驟前方的 ≡ 來調整步驟順序。
在此模式中,你可以使用「⬆️」和「⬇️」鍵在所選測試步驟之間快速切換。
編排模式概覽
在編排模式中,你可以編輯多個步驟,然後點擊左上角的「Save All」按鈕以儲存所有變更。
如果任何步驟有未儲存的變更,該步驟會在左側列表列中以圓點標記。請記得務必儲存你所做的變更。
未儲存變更指示器
Modified at 2026-06-11 10:26:02
Previous
概述
Next
在請求之間傳遞資料
Built with