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. 測試情境

在請求之間傳遞資料

在自動化測試情境中,在多個請求之間傳遞資料非常常見。典型案例包括:
請求 1 是登入請求,會回傳 token;請求 2 使用此 token 來請求其他資料。
請求 1 回傳一個 ID;請求 2 根據此 ID 執行操作。
請求 1 回傳一個清單;請求 2 使用此清單中的資料。
針對這類情境,Apidog 提供兩種不同的解決方案來處理請求之間的資料傳遞。你可以根據當前的具體問題選擇合適的方案。
方法優點限制可用範圍
擷取前置步驟資料簡單,不需要額外變數當資料需要被多次引用時稍微繁瑣僅限 Tests 模組
使用變數方便多次引用對於單次引用來說稍微複雜Tests 和 APIs 模組

擷取前置步驟資料#

讓我們考慮一個情境:請求 1 是登入請求,會回傳 token,而請求 2 使用此 token 來請求其他資料。
1
將登入請求(請求 1)新增到測試情境中。
2
將查詢請求(請求 2)新增到測試情境中。
3
請求 2 的查詢參數需要包含請求 1 回傳的 token。點擊請求 2 查詢參數中 token 欄位的「魔法棒」圖示 🪄,並選擇「擷取前置步驟資料」。
4
選擇請求 1 進行資料擷取,選擇回應主體,並使用 JSONPath 擷取請求 1 回傳的 token,例如 $.token。
5
點擊 Insert,你會看到 {{$.2.response.body.token}} 作為查詢參數被插入。
6
在測試情境中點擊「Run」按鈕,即可成功將資料從請求 1 傳遞到請求 2。
「擷取前置步驟資料」功能僅可在「Tests」模組中使用,無法在「APIs」模組中使用。
使用「擷取前置步驟資料」時,只有在整個測試情境一起執行時才能取得該值;執行單一步驟時無法存取。

使用變數語法引用前置步驟資料#

以前文中的 {{$.2.response.body.token}} 為例:
'2' 代表步驟 ID,可在每個測試步驟中找到。
'response.body' 表示前置步驟資料的位置。這可以包含請求的標頭、主體,或回應的標頭、主體等資料。具體內容請見下方。
'token' 代表主體中下一層的 'token' 資料。你可以使用 JSONPath 語法擷取所需資料。
前置步驟資料可用於請求的各個部分,例如請求參數、標頭、驗證等。你也可以將資料直接插入到請求主體中,如下所示。
需要注意的是,如果你需要在腳本中使用前置步驟資料,不能直接使用 {{variable}} 語法引用變數。相反地,你應該使用 pm.variables.get 來引用前置步驟資料。例如:

語法參考#

類別功能語法範例
請求URL{{$.<step id>.request.url}}
路徑參數{{$.<step id>.request.pathParam.<field name>}}
查詢{{$.<step id>.request.query.<field name>}}
標頭{{$.<step id>.request.header.<field name>}}
主體(form){{$.<step id>.request.body.<field name>}}
主體(json){{$.<step id>.request.body.<field path>}}
回應主體{{$.<step id>.response.body.<field path>}}
標頭{{$.<step id>.response.header.<field name>}}
Cookie{{$.<step id>.response.cookie.<field name>}}
迴圈元素(ForEach 迴圈中的陣列元素){{$.<loop step id>.element.<field path>}}
索引{{$.<loop step id>.index}}

使用變數傳遞資料#

讓我們考慮一個情境:請求 1 是登入請求,會回傳 token,而請求 2 使用此 token 來請求其他資料。
1
將登入請求(請求 1)新增到測試情境中。
2
在請求 1 的後置處理器中,新增一個「Extract Variable」動作,將 $.token 擷取為 {{token}}。
了解更多關於 Extract variable 的資訊。
3
將查詢請求(請求 2)新增到測試情境中。
4
在請求 2 的查詢參數中引用變數 {{token}}。
5
在測試情境中點擊「Run」按鈕,即可成功將資料從請求 1 傳遞到請求 2。

FAQ#

Q: 為什麼我無法成功引用前置步驟資料?
A: 首先,請確認你目前位於「Tests」模組。「引用前置步驟資料」功能僅可在 Tests 模組中使用,無法在 APIs 模組中使用。
如果你已確認目前位於 Tests 模組,請切換到「Actual Request」分頁,以確認請求中引用的前置步驟資料是否已成功帶入。
如果實際請求中的引用仍顯示為 {{$.n.response.body.abc}},而不是顯示實際資料,則表示該引用尚未生效。
在這種情況下,請考慮以下常見原因:
1.
你是否執行了整個測試情境,而不是只執行單一步驟?引用前置步驟資料需要執行完整的測試情境才會生效。
2.
確認步驟 ID 是否正確,且對應到你想要引用的步驟。
3.
確保使用的 JSONPath 與資料來源準確匹配。
Modified at 2026-06-11 10:26:02
Previous
建立測試情境
Next
流程控制條件
Built with