動態值

在上章的「使用者生命週期」範例中，我們簡要提到了使用 {{$randomUserName}} 來驗證使用者註冊。這個簡單的技巧實際上是一個強大功能的一部分，稱為 動態值。

當您在步驟之間傳遞資料時，您使用的是真實資料。但通常，您需要虛假但逼真的資料來使您的測試穩健且可重複。

為了解決這個問題，我們使用 動態值。

什麼是動態值？

動態值是 Apidog 內建的特殊變數（類似於 "Faker" 函式庫），每次發送請求時都會生成隨機資料。

它們遵循語法 {{$variableName}}。

為什麼使用它們？

避免衝突：永遠不會得到「重複鍵」錯誤。

逼真：每次都用不同的名稱、電子郵件和號碼進行測試。

方便：無需手動輸入 "test user 1"、"test user 2"。

常見動態變數

以下是日常測試中最有用的幾個：

識別碼

{{$guid}}：唯一的 UUID（例如 d4f5-a1b2-...）。非常適合 Request ID 或 Trace ID。

{{$timestamp}}：當前 Unix 時間戳（例如 1678886472）。

個人資料

{{$randomUserName}}：隨機使用者名稱（例如 brave_lion）。

{{$randomEmail}}：隨機電子郵件（例如 example@xyz.com）。

{{$randomPhoneNumber}}：隨機電話號碼。

數字與字串

{{$randomInt}}：0 到 1000 之間的隨機整數。

{{$randomString}}：隨機文字字串。

提示：Apidog 提供了數百種這樣的變數。只需在任何值欄位中輸入 {{$，自動完成列表就會出現。或者點擊 Magic Wand（魔術棒）圖標來瀏覽完整列表。

真實案例：隨機使用者註冊

讓我們修復我們的「使用者註冊」測試，使其永遠不會因重複電子郵件錯誤而失敗。

舊 Body（靜態）：

{
  "username": "testuser",
  "email": "test@example.com",
  "password": "Password123"
}

新 Body（動態）：

{
  "username": "{{$randomUserName}}",
  "email": "{{$randomUserName}}@example.com",
  "password": "Password123"
}

現在，每次運行此測試時，Apidog 都會生成一個新使用者：

運行 1："username": "blue_sky"

運行 2："username": "fast_tiger"

在參數中使用動態值

您也可以在查詢參數中使用它們。

GET /items?cacheBuster={{$timestamp}}

這確保伺服器永遠不會返回快取的回應，因為 URL 始終是唯一的。

關鍵重點

使用 動態值 防止資料衝突和「重複鍵」錯誤。

掌握常見變數如 {{$timestamp}}、{{$guid}} 和 {{$randomUserName}}。

應用動態資料使您的測試穩健且可重複，無需手動清理。

下一步

既然我們有在請求之間流動的資料（整合）和每次運行的唯一資料（動態值），我們需要確保 API 實際上返回正確的結果。

在下一章中，我們將深入探討 斷言和驗證。

繼續閱讀 → 斷言和驗證

什麼是動態值？#

為什麼使用它們？#

常見動態變數#

識別碼#

個人資料#

數字與字串#

真實案例：隨機使用者註冊#

在參數中使用動態值#

關鍵重點#

下一步#