API 測試筆記|Postman 變數與環境參數怎麼用

更新 發佈閱讀 4 分鐘

在使用 Postman 測試 API 時,只要開始碰到多個環境、不同帳號或重複請求,就一定會用到「變數」。

把值抽成變數後,請求本身會變得乾淨,也比較不容易改錯。

這篇整理的是我實際使用 Postman 時,最常用、也最容易搞混的變數與環境參數觀念。


什麼是 Postman 變數

Postman 的變數可以用來儲存並重複使用值,例如:

  • API Base URL
  • 帳號、Token
  • 常用參數或路徑片段

設定成變數後,就能在整個集合、環境、請求或測試腳本中引用,避免到處複製貼上。

官方文件可參考:

https://learning.postman.com/docs/sending-requests/variables/



變數的基本用法

變數的使用方式很單純,使用 雙大括號 包住變數名稱:

{{account}}

即使這個變數還沒設定,也可以先直接打。

滑鼠移到未設定的變數上,Postman 會顯示提示訊息,提醒這個變數目前沒有值。

未設定的變數

未設定的變數


未設定變數時會發生什麼事

當你看到變數底下出現提示,表示:

  • 這個變數名稱存在
  • 但目前還沒有任何作用範圍有設定值

此時可以直接點選 Add new Variable,進入設定畫面。

設定變數

設定變數


變數設定欄位說明

新增或編輯變數時,會看到三個重點欄位:

  • Name:變數名稱
  • Value:實際使用的值
  • Scope:變數的作用範圍

其中 Scope 是最多人一開始會搞混的地方。


變數的作用範圍(Scope)

Postman 的變數依作用範圍區分,常見有幾種:

  • Global:整個 Postman 都能用
  • Environment:只在指定環境中生效
  • Collection:只在某一組 API Collection 中使用
  • Local:只在單一請求或測試中暫時存在

實務上最常用的是 EnvironmentCollection

如果你有「開發/測試/正式環境」,Base URL 幾乎一定會放在 Environment。

如果是某組 API 專用的參數,放在 Collection 會比較安全。

變數作用範圍

變數作用範圍



如何確認變數目前的值

當變數設定完成後,只要把滑鼠移到請求中的變數名稱上,就能看到:

  • 目前實際使用的值
  • 來自哪一個 Scope

這在除錯時非常有用,可以快速確認是不是用錯環境。

raw-image

簡單使用情境整理

設定好變數後滑鼠指著變數就會顯示變數的資訊

幾個常見的搭配方式:

  • {{baseUrl}}/api/users
  • Authorization: Bearer {{token}}
  • 測試腳本中先設定變數,再給下一個請求使用

只要習慣把「會重複出現的值」抽成變數,Postman 的可讀性會差很多。


補充文件

如果要更深入了解環境與管理方式,可以參考官方文件:

留言
avatar-img
麟製所
2會員
60內容數
軟體、旅遊分享
麟製所的其他內容
2025/06/03
Postman Collection 是一個 API 請求的管理工具,可以幫助使用者組織、分類和協作 API 請求。本文介紹 Postman Collection 的主要功能,包括組織與分類、團隊協作,並以 ClickUp 的 Postman Collection 範例說明如何使用。
Thumbnail
2025/06/03
Postman Collection 是一個 API 請求的管理工具,可以幫助使用者組織、分類和協作 API 請求。本文介紹 Postman Collection 的主要功能,包括組織與分類、團隊協作,並以 ClickUp 的 Postman Collection 範例說明如何使用。
Thumbnail
2022/07/18
這個應用程式提供團隊成員追蹤任務進度、互相溝通的平臺。它整合了任務列表、留言功能以及任務標記功能,方便團隊成員查看任務、討論問題並追蹤相關資訊。相較於外部通訊軟體,此應用程式避免了訊息遺失、任務混淆等問題,提升團隊協作效率。
Thumbnail
2022/07/18
這個應用程式提供團隊成員追蹤任務進度、互相溝通的平臺。它整合了任務列表、留言功能以及任務標記功能,方便團隊成員查看任務、討論問題並追蹤相關資訊。相較於外部通訊軟體,此應用程式避免了訊息遺失、任務混淆等問題,提升團隊協作效率。
Thumbnail
2022/06/17
這篇文章提供一個簡單易懂的任務管理方法,適合個人或團隊使用任何專案管理軟體。文章闡述了任務記錄、狀態轉換(待處理、處理中、完成、關閉)以及團隊協作時的注意事項,強調以書面記錄取代腦力記憶以提升效率,避免遺漏任務。
Thumbnail
2022/06/17
這篇文章提供一個簡單易懂的任務管理方法,適合個人或團隊使用任何專案管理軟體。文章闡述了任務記錄、狀態轉換(待處理、處理中、完成、關閉)以及團隊協作時的注意事項,強調以書面記錄取代腦力記憶以提升效率,避免遺漏任務。
Thumbnail
看更多
你可能也想看
Thumbnail
債券投資,不只是高資產族群的遊戲 在傳統的投資觀念中,海外債券(Overseas Bonds)常被貼上「高資產族群專屬」的標籤。過去動輒 1 萬甚至 10 萬美元的最低申購門檻,讓許多想尋求穩定配息的小資族望而卻步。 然而,在股市波動劇烈的環境下,尋求穩定的美元現金流與被動收入成為許多投資人
Thumbnail
債券投資,不只是高資產族群的遊戲 在傳統的投資觀念中,海外債券(Overseas Bonds)常被貼上「高資產族群專屬」的標籤。過去動輒 1 萬甚至 10 萬美元的最低申購門檻,讓許多想尋求穩定配息的小資族望而卻步。 然而,在股市波動劇烈的環境下,尋求穩定的美元現金流與被動收入成為許多投資人
Thumbnail
透過川普的近期債券交易揭露,探討債券作為資產配置中「穩定磐石」的重要性。文章分析降息對債券的潛在影響,以及股神巴菲特的操作策略。並介紹玉山證券「小額債」平臺,如何讓小資族也能低門檻參與海外債券市場,實現「低門檻、低波動、固定收益」的務實投資方式。
Thumbnail
透過川普的近期債券交易揭露,探討債券作為資產配置中「穩定磐石」的重要性。文章分析降息對債券的潛在影響,以及股神巴菲特的操作策略。並介紹玉山證券「小額債」平臺,如何讓小資族也能低門檻參與海外債券市場,實現「低門檻、低波動、固定收益」的務實投資方式。
Thumbnail
解析「債券」如何成為資產配置中的穩定錨,提供低風險高回報的投資選項。 藉由玉山證券的低門檻債券服務,投資者可輕鬆入手,平衡風險並穩定財務。
Thumbnail
解析「債券」如何成為資產配置中的穩定錨,提供低風險高回報的投資選項。 藉由玉山證券的低門檻債券服務,投資者可輕鬆入手,平衡風險並穩定財務。
Thumbnail
相較於波動較大的股票,債券能提供固定現金流,而玉山證券推出的小額債,更以1000 美元的低門檻,讓學生與新手也能參與全球優質企業債投資。玉山E-Trader平台即時報價、條件式篩選與清楚的交易流程等特色,大幅降低投資難度,對於希望分散風險、建立穩定現金流的人來說,玉山小額債是一個值得嘗試的理財起點。
Thumbnail
相較於波動較大的股票,債券能提供固定現金流,而玉山證券推出的小額債,更以1000 美元的低門檻,讓學生與新手也能參與全球優質企業債投資。玉山E-Trader平台即時報價、條件式篩選與清楚的交易流程等特色,大幅降低投資難度,對於希望分散風險、建立穩定現金流的人來說,玉山小額債是一個值得嘗試的理財起點。
Thumbnail
一般來說,如果要測試網路速度,大概有 90% 的人會說用 Speedtest 之類的 App 來測試就可以了。但你知道嗎?這種測試方式是綜合測試,就是加入了頻寬、基地台、對方網站限速的多種因素,如果你是要測試這種泛數據,確實 Speedtest 就能滿足你當下的需求,反正你只是要測看看當下的網路在多
Thumbnail
一般來說,如果要測試網路速度,大概有 90% 的人會說用 Speedtest 之類的 App 來測試就可以了。但你知道嗎?這種測試方式是綜合測試,就是加入了頻寬、基地台、對方網站限速的多種因素,如果你是要測試這種泛數據,確實 Speedtest 就能滿足你當下的需求,反正你只是要測看看當下的網路在多
Thumbnail
隨著AI科技的發展,「氛圍編程」(Vibe Coding)成為程式設計的新浪潮,使用者即便不具備程式語言基礎,也能透過自然語言描述需求,由 AI 自動生成程式碼。
Thumbnail
隨著AI科技的發展,「氛圍編程」(Vibe Coding)成為程式設計的新浪潮,使用者即便不具備程式語言基礎,也能透過自然語言描述需求,由 AI 自動生成程式碼。
Thumbnail
稍微看一下 Telegram 官方文件,哇!好強喔,功能說明的第一項赫然出現「可以取代整個網站」!口氣真的很大。雖然我的需求應該很低,但能夠確認前面是一座豐富的寶藏,還是很令人興奮的,待基本功能掌握之後,可以再評估和決定要不要往下挖。 發送訊息 要達成這第一個目標,首先必須建立一個 bot。
Thumbnail
稍微看一下 Telegram 官方文件,哇!好強喔,功能說明的第一項赫然出現「可以取代整個網站」!口氣真的很大。雖然我的需求應該很低,但能夠確認前面是一座豐富的寶藏,還是很令人興奮的,待基本功能掌握之後,可以再評估和決定要不要往下挖。 發送訊息 要達成這第一個目標,首先必須建立一個 bot。
Thumbnail
這篇文章介紹瞭如何利用正則表達式來驗證網址格式,並詳細解釋每個符號的作用。文章也簡要說明瞭 HTTP 和 HTTPS 之間的差異,並探討了現代網站為何傾向於使用 HTTPS 以保障資料安全。此外,還提供了測試範例,讓讀者能更好理解網址驗證的過程和原理。
Thumbnail
這篇文章介紹瞭如何利用正則表達式來驗證網址格式,並詳細解釋每個符號的作用。文章也簡要說明瞭 HTTP 和 HTTPS 之間的差異,並探討了現代網站為何傾向於使用 HTTPS 以保障資料安全。此外,還提供了測試範例,讓讀者能更好理解網址驗證的過程和原理。
追蹤感興趣的內容從 Google News 追蹤更多 vocus 的最新精選內容追蹤 Google News