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. 開發和偵錯 API
  • 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. 開發和偵錯 API

動態值

當你在 Apidog 中偵錯端點時,通常需要在請求參數、請求主體等位置產生一個值、名稱、地址或其他資料點。這時,動態值功能就能派上用場。
動態值可讓你每次傳送請求時,根據預先定義的規則產生一個新值。這有助於簡化偵錯流程,並確保每個請求都包含唯一資料。

開始使用#

1
在端點中,切換到 Run 分頁。
2
針對你想要動態化的參數,刪除原始值,然後點擊該值右側的 magic wand 圖示。在此範例中,我會選擇 name 參數。
3
點擊 Data generator,並選擇你需要的動態值類型,例如 Person.firstName。
4
點擊 Insert,將動態值插入到參數中。
5
點擊 Send。你可以在 Actual request 中看到實際傳送的名稱是 "Jennifer"。
6
再次傳送請求,就會動態產生新的名字。

在 JSON 主體中使用動態值#

如果你需要提交 JSON 主體,且 JSON 中的某些值需要動態產生,也可以使用動態值。
1
找到一個具有 JSON 主體的 POST 端點,並切換到 Run 分頁。
2
在 JSON 主體中,點擊 Generate automatically -> Generate field names,你將取得規格中定義的屬性名稱。
3
將游標放在正確位置,點擊 Insert dynamic value,並選擇 Data Generator。
4
選擇適當的資料類型,並點擊 Insert。
5
為所有欄位新增值。
6
點擊 Send。你可以在 Actual request 區段中看到實際傳送的 JSON 主體。
7
如果你再次傳送請求,動態值將會產生新的 JSON 主體。

在自訂自訂運算式中使用動態值#

如果你需要自訂一段資訊字串,且該資訊中的某些值需要動態產生,也可以點擊 Custom expression 並輸入動態值運算式。
1
點擊動態運算式以開啟輸入框。
2
透過串接等方式輸入動態值運算式,以產生預期內容。你可以在下方即時預覽產生的資訊。
3
點擊 Insert。你可以在參數值區段中看到自訂運算式。
以下是一些常見的自訂動態值範例。你也可以點擊 Dynamic Values Modules 查看更多動態值方法。
期望的自訂內容自訂運算式範例回傳值方法串接與含義
帶有時間戳記的隨機使用者名稱{{$internet.userName}}_{{$date.now}}"Kattie_Rice64_2024-09-04T05:51:42.413Z"使用 {{$internet.userName}} 產生隨機使用者名稱,使用 {{$date.now}} 取得目前時間,並使用範本字面值將它們串接起來。
帶有公司網域的隨機電子郵件地址`{{person.lastName}}@{{$company.namelower}}.com`"Kole.Haag@schmidt-schoen.com"
帶有街道門牌號與公寓號碼的隨機地址{{$location.buildingNumber}} {{$location.street}}, Apt. {{$number.int(min=1,max=1000)}}, {{$location.city}}, {{$location.state(abbreviated=true)}} {{$location.zipCode}}"723 Klein Inlet, Apt. 814, North Myron, DE 67605"使用多個方法產生詳細地址,包括街道門牌號、街道名稱、公寓號碼、城市、州與郵遞區號。
帶有產業與公司類型的隨機公司名稱{{$company.buzzAdjective}} {{$company.buzzNoun}} {{$company.name}}"web-enabled architectures Fay Inc"使用 company 方法產生帶有產業描述與公司類型的公司名稱。
過去一年內的隨機日期{{$date.past(years=1)}}"2023-10-24T09:25:24.109Z"使用 {{$date.past(years=1)}} 方法產生過去一年內的隨機日期。
帶有貨幣符號的隨機價格{{$finance.currencySymbol}}{{$commerce.price}}"KM12.89"使用 {{$finance.currencySymbol}} 產生隨機貨幣符號,使用 {{$commerce.price}} 產生隨機價格,並將它們串接起來。
隨機產品描述{{$commerce.productAdjective}} {{$commerce.productMaterial}} {{$commerce.product}} - {{$lorem.sentences(min=2,max=4)}}"Small Wooden Pizza - Thema copiose dens adinventitias a. Causa uxor terreo defleo vitiosus animi. Ademptio possimus decet considero absorbeo sursum rem circumvenio antiquus curatio. Adipisci addo tredecim carbo."使用 {{$commerce.productAdjective}} 與 {{$lorem.sentences(min=2,max=4)}} 方法產生包含產品特性與描述的文字。
帶有主題標籤的隨機句子#{{$lorem.slug(min=1,max=3)}} {{$lorem.sentence(min=1,max=3)}}"#provident-quidem-tempore Vita comprehendo id."使用 {{$lorem.slug(min=1,max=3)}} 產生隨機主題標籤,並將其串接在句子前方。
帶有連接埠號碼的隨機 IP 位址{{$internet.ipv4}}::{{$number.int(min=1024,max=65535)}}"246.222.133.63::56332"使用 {{$internet.ipv4}} 產生隨機 IP 位址,使用 {{$number.int(min=1024,max=65535)}} 產生連接埠號碼,並將它們串接起來。
帶有查詢參數的隨機 URL{{$internet.url}}?{{$lorem.slug}}={{$lorem.word}}"https://nippy-bob.name/?nemo-provident-clementia=blandior"使用 {{$internet.url}}、{{$lorem.slug}} 與 {{$lorem.word}} 產生帶有查詢參數的隨機 URL。
隨機檔案路徑/path/to/{{$lorem.slug}}/{{$system.fileName}}"/path/to/caritas-solio-vilicus/across.img"使用 {{$lorem.slug}}、{{$system.fileName}} 與字串串接來產生隨機檔案路徑。
隨機資料庫資料表名稱`table_{{$string.alphanumeric(length=5)lower}}`"table_brxlr"
隨機 HTML 程式碼片段<p>{{$lorem.sentence}} <a href="{{$internet.url}}">{{$lorem.word}}</a></p><p>Calamitas velociter una succurro depopulo. <a href="https://feline-king.name/">comminor</a></p>使用 {{$lorem.sentence}} 與 {{$internet.url}} 產生包含連結的隨機 HTML 程式碼片段。
隨機 HTTP 請求標頭{ "User-Agent": {{$internet.userAgent}}, "Referer": {{$internet.url}} }{ "User-Agent": Opera/13.25 (Macintosh; Intel Mac OS X 10.7.9 U; HE Presto/2.9.171 Version/12.00), "Referer": https://queasy-dusk.info/ }使用 {{$internet.userAgent}} 與 {{$internet.url}} 產生包含 User-Agent 與 Referer 的隨機 HTTP 請求標頭。

動態變數的使用案例#

動態變數在 API 測試中有廣泛的應用。以下是幾個典型範例:
模擬真實世界資料:你需要測試 API 如何處理不同類型的資料,例如各種格式的使用者名稱、地址或電子郵件地址。使用動態變數,你可以輕鬆產生大量類似真實世界情境的測試資料,提升測試涵蓋率。
產生唯一值:在某些測試情境中,你需要確保資料唯一性,例如產生訂單編號、使用者 ID 或交易 ID。動態變數可以根據時間戳記或隨機數產生唯一值,避免資料衝突並確保測試結果準確。
簡化資料處理:不要為每次測試執行手動修改資料,而是使用動態變數自動產生所需資料。這能為你節省大量時間與精力,提升測試效率。

手動插入動態值#

在需要插入動態變數的輸入欄位中,你可以輸入 {{$ 來觸發動態變數清單。
你可以使用以下其中一種方法快速找到所需變數:
完整輸入:準確輸入完整的動態變數名稱,例如 $timestamp。
模糊比對:輸入部分關鍵字,例如 time,系統會自動篩選並顯示符合的動態變數。
選擇目標動態變數,將其插入到輸入欄位中。
TIP
此方法不支援直接為動態變數新增參數或函式。

資料產生器#

使用資料產生器,你可以依需求產生任何自訂資料。
將滑鼠懸停在參數輸入欄位上,並點擊出現的魔法棒圖示,以開啟功能更強大的 Data Generator 面板。
你可以使用兩種方法在面板中找到所需的動態變數:
依變數類型搜尋:透過選擇動態變數類型,例如「Date」、「String」、「Number」等,快速定位所需的變數範圍,以提高搜尋效率。
依關鍵字搜尋:在上方的「Type」輸入框中輸入關鍵字,例如「time」,系統會自動篩選並顯示符合的動態變數,讓你更容易快速定位。
選擇所需的動態變數後,你可以進一步透過以下操作細化它,以滿足更細緻的資料產生需求:
新增方法:部分動態變數支援其他方法,例如 {{$date.now}},可使用 addDays 方法新增天數,以產生特定日期的資料。
新增處理函式:所有動態變數結果都可以透過函式處理,例如使用 md5 函式加密字串,並產生符合安全需求的測試資料。
Expression 區域會清楚顯示你目前選取的動態變數、方法與函式,方便你檢查與修改。
Preview 區域會即時顯示由動態變數產生的範例資料。點擊 Preview 區域末端的 Refresh 按鈕,即可產生新的範例資料,讓你輕鬆查看資料產生效果。
點擊 Preview 區域中的範例資料即可自動複製內容,方便你貼到需要的位置。

常數#

你可以使用 Constant 將一段靜態文字包裝在 Dynamic Value 語法中,以便之後新增處理函式。常見使用案例包括套用 MD5 雜湊、Base64 編碼 或 變更字母大小寫。
使用常數時,請輸入原始值,並在語法中手動新增所需的處理函式。系統會在執行期間自動處理加密或轉換。
如果值純粹是靜態的,且不需要任何處理,你可以直接以純文字輸入,無需使用 Constant。

設定資料語言/國家#

Apidog 的動態變數支援以不同語言產生範例資料,以滿足你在多語言環境中的測試需求。方法如下:
1.
開啟 Data Generator 面板。
2.
對於日期與時間以外的動態變數類型,點擊動態變數右上角的設定按鈕,並選擇目標語言。
3.
對於日期與時間動態變數類型,你可以使用 format 與 locale 方法指定語言與格式。

強大的日期操作與格式化#

Apidog 不僅提供豐富的日期與時間動態值,也致力於簡化你的開發流程。以下是你可以輕鬆實現的一些功能:
彈性的時間調整:使用 add 方法,你可以根據目前時間輕鬆新增或減去時間單位。例如,{{$date.now|addHours(-3)}} 會回傳比目前時間早 3 小時的日期。
多樣化的日期格式化:透過 format 方法,你可以依需求將日期格式化為不同格式。例如,{{$date.now|formatISO}} 會依照 ISO 8601 標準格式化日期。
精確的時區控制:透過設定 timezone 參數,你可以輕鬆控制日期的時區。例如,{{$date.now|format('yyyy-MM-dd HH:mm:ss',timezone='America/Port-au-Prince')}} 會回傳 UTC+8:00 時區中對應目前時間的日期。

常見動態變數#

為了協助你充分利用 Apidog Dynamic Values,我們整理了一份可用值的完整清單,並附上清楚範例。你可以點擊 Dynamic Values Modules 快速找到所需的值,並了解如何有效使用它們。
TIP
你也可以在 Apidog 應用程式中將滑鼠懸停在 Dynamic Value 運算式上,以查看簡短描述與範例。
Modified at 2026-06-11 10:26:02
Previous
測試案例
Next
驗證回應
Built with