1. 概述

在 Postman 中，變量允許我們保存值並在不同的 API 中根據需要使用它們。我們可以通過將這些值傳遞到集合、環境或任何請求中來引用這些值。這基本上使我們能夠更有效地使用這些變量來訪問存儲的值。我們還可以使用這些變量與多名團隊成員協作或在 Postman 中設置動態工作流程。

在本文中，我們將深入瞭解變量、它們的類型以及如何將它們嵌入到我們的 API 中。

2. 變量是什麼？

變量代表數據表示，讓我們在需要的地方訪問值，而無需手動輸入。它們在我們需要在多個地方使用相同的值時非常有用。一些例子包括基本 URL、令牌和路徑變量。此外，使用它們還使請求更具靈活性，因為更改變量會自動在所有使用這些變量的地方進行更改。

我們可以像在 Postman 中定義變量，它們是鍵值對。鍵定義了變量名，允許我們使用此鍵直接訪問其值。

此外，還可以使用環境來設置一組變量。這些變量的值將取決於所選的環境。

讓我們深入瞭解變量及其不同的變量作用域。

2.1. 變量作用域

有多個作用域，使我們可以在具有不同值的各種環境中處理和測試 API。以下是按最廣到最窄的範圍定義的變量作用域：

• 全局變量：這些變量在 Postman 工作區中可訪問，具有最廣泛的作用域。它們可用於工作區中的多個請求和集合中的任何地方。
• 集合變量：這些變量僅在特定集合內部可訪問。它們在集合中的所有請求中可用，並且不會因所選環境而異。
• 環境變量：這些變量使我們能夠根據不同的環境進行範圍劃分。它們會隨着我們所使用的環境（例如本地、測試或生產環境）的變化而變化。
• 數據變量：這些類型的變量是外部的，定義了在與 Collection Runner 運行集合時的數據集。我們可以從 CSV 或 JSON 文件中提取它們。它們具有當前值，在請求或集合執行後不會持久化。
• 本地變量：這些變量也稱為臨時變量，只能通過請求腳本訪問。它們的範圍僅限於當前請求或集合。執行完成後，它們將不再可用。

2.2. 變量類型

全局和環境變量可以根據類型進一步分類。以下是如何配置它們的示例：

• 默認類型：變量的默認類型為文本，沒有其他屬性。
• 密鑰類型：這些變量隱藏所有工作區中的初始和當前值，類似於密碼。它們可以防止敏感數據意外泄露。

3. Defining Variables With Scopes

我們可以在請求構建器中定義多種類型的變量，並具有範圍，如我們在上面討論的。變量可以在請求構建器中的任何範圍內定義。

首先，我們選擇文本並點擊 Set as a variable。 完成後，我們需要將其存儲為新的變量。 然後，我們為值輸入一個鍵，並從 Postman 可用的不同範圍內選擇它：

3.1. Setting the Response Body as Variables

請求響應體中的值也可以設置為變量，並在集合中進一步使用。 這有助於在序列中運行多個請求，並創建特定流程。

首先，讓我們選擇我們要保存的文本，然後點擊 right-click 或 Control-click 按鈕將其存儲為變量。

完成之後，我們需要從可能的選項中選擇與相關範圍相符的選項，即環境、本地或全局，併為該變量命名：

3.2. Defining Global Variables

下面是設置 Postman 中全局變量的步驟：

1. 我們首先通過點擊 Add a new variable 在全局變量部分，然後輸入變量名稱以直接將其存儲為全局變量。
2. 另一個選項是選擇值並使用選擇“全局”作為類型來存儲變量。
3. 完成之後，我們不應該忘記點擊 保存更改。

我們還可以通過以下步驟下載全局變量並與他人共享它們：

1. 首先，在側邊欄中選擇 Postman 並選擇“全局”作為環境類型。
2. 然後，我們可以點擊 Export 按鈕，該按鈕會將變量導出到文件。
3. 完成之後，我們可以通過點擊 Save 在系統上保存文件，並根據需要共享它。

3.3. Defining Environment Variables

下面是保存 Postman 中環境變量的步驟：

1. 首先，我們點擊 Add a new variable，並輸入變量名稱。
2. 在保存變量之前，我們可以 select the variable type as the environment.
3. 變量需要指定初始和當前值。
4. 完成之後，我們必須點擊 保存以確認更改。

3.4. Defining Collection Variables

Postman 還提供添加集合變量並根據需要使用它們的機會。

我們必須點擊並選擇 Collections 在側邊欄中，完成之後，選擇 Variables 標籤以存儲集合變量：

3.5. Defining Variables in Scripts

類似於在集合、環境或全局中定義變量，我們也可以在請求腳本中以編程方式設置變量。

所有這些方法都接受 (variable_key, variable_value) 作為輸入：

1. pm.globals: 此方法用於在請求腳本中定義全局變量，例如 pm.globals.set(“variable_key”, “variable_value”);
2. pm.collectionVariables: 我們可以使用此方法定義 一個具有“collection”範圍的變量，例如：pm.collectionVariables.set(“variable_key”, “variable_value”);
3. pm.environment: 它可以用於 定義具有當前環境範圍的環境變量，例如：pm.environment.set(“variable_key”, “variable_value”);
4. pm.variables: 它定義具有本地/臨時範圍的本地變量，例如：pm.variables.set(“variable_key”, “variable_value”);
5. unset: 此方法可用於刪除已設置的變量。 可以根據其範圍使用上述變量實例，例如：pm.environment.unset(“variable_key”, “variable_value”);

3.6. Using Variables in Scripts

我們已經使用上述方法在腳本中存儲變量。 因此，我們可以使用這些方法檢索其當前值：

1. pm.variables.get(“variable_key”): 這將訪問任何範圍中的變量，包括本地。
2. pm.globals.get(“variable_key”): 這可以訪問全局變量
3. pm.collectionVariables.get(“variable_key”): 這可以訪問集合變量。
4. pm.environment.get(“variable_key”): 這可以訪問環境變量。

在此，我們可以使用 variable_key 檢索值。 對象表示範圍級別，並且 get() 方法檢索值。

pm.variables.get() 方法還提供了一種在不影響腳本功能的情況下更改變量範圍的選項。 它返回當前具有最高預cedence的變量。

4. 使用變量

現在，我們已經定義了不同的變量作用域，並學習瞭如何在Postman中存儲它們。讓我們看看如何使用這些變量在請求路徑和主體中。

為了在Postman中引用變量，我們應該使用變量名稱周圍的雙花括號。 它會自動從不同的變量中檢索值，根據定義。這在Postman的各個版本中都是標準，並且不取決於變量類型和作用域：

{{studentName}}

此外，運行CURL或發送請求將解析變量並使用當前存儲的值更新變量。下面的請求 URL 引用了變量：

http://localhost:8080/get?student_name={{studentName}}

假設 是“John”。Postman 從其變量中檢索值，併發送當前存儲的值。因此，在Postman 上命中上述請求後，它會自動將其轉換為請求：

http://localhost:8080/get?student_name=John