Postman 導(dǎo)航

Postman 有多種工具、視圖和控件來(lái)幫助您管理 API 項(xiàng)目。本指南是對(duì) Postman 主要界面區(qū)域的高級(jí)概述：

標(biāo)頭

標(biāo)頭使您能夠創(chuàng)建工作區(qū)、訪問(wèn)報(bào)告、探索公共 API 網(wǎng)絡(luò)、在 Postman 中搜索、查看同步狀態(tài)和通知，以及訪問(wèn)您的設(shè)置、帳戶和 Postman計(jì)劃。

• ← → - 在您在 Postman 中訪問(wèn)過(guò)的頁(yè)面中前后導(dǎo)航。（僅限 Postman 桌面應(yīng)用程序）
• 主頁(yè)- 轉(zhuǎn)到您的個(gè)人主頁(yè)，其中包括提醒、公告、您的活動(dòng)提要、您最近訪問(wèn)的工作區(qū)以及您的團(tuán)隊(duì)資源的鏈接（如果適用）。
• 工作區(qū)- 搜索工作區(qū)、查看您最近訪問(wèn)過(guò)的工作區(qū)或創(chuàng)建新的工作區(qū)。
• API 網(wǎng)絡(luò)- 探索公共 API 網(wǎng)絡(luò)并訪問(wèn)您團(tuán)隊(duì)的私有 API 網(wǎng)絡(luò)。
• Explore - 瀏覽 Postman 上的公共 API、團(tuán)隊(duì)、工作區(qū)和集合。

•  搜索 Postman - 搜索 Postman 中的所有工作區(qū)、集合、API 和團(tuán)隊(duì)。有關(guān)在 Postman 中搜索的更多詳細(xì)信息，請(qǐng)參閱搜索 Postman。

• 邀請(qǐng)- 如果您在工作區(qū)中擁有管理員角色，則可以邀請(qǐng)其他用戶進(jìn)行協(xié)作。
•  設(shè)置- 訪問(wèn)Postman 設(shè)置和其他 Postman 資源。
•  通知- 查看團(tuán)隊(duì)最近的活動(dòng)，獲取有關(guān) Postman 更新的通知，并查看拉取請(qǐng)求、評(píng)論活動(dòng)和其他重要信息。
• 您的頭像- 查看您的個(gè)人資料、訪問(wèn)您的帳戶和通知設(shè)置、查看您帳戶的所有活動(dòng)會(huì)話或退出您的帳戶。
• 團(tuán)隊(duì)（付費(fèi)計(jì)劃）或升級(jí)（免費(fèi)計(jì)劃）- 查看資源使用情況并訪問(wèn)您的計(jì)費(fèi)儀表板和其他帳戶管理工具。

搜索郵遞員

要在 Postman 中搜索，請(qǐng)?jiān)跇?biāo)題中選擇搜索 Postman ，然后輸入您的搜索詞。您還可以使用鍵盤快捷鍵?+K或Ctrl+K。要將搜索范圍更改為您的個(gè)人或團(tuán)隊(duì)空間或公共 API 網(wǎng)絡(luò)，請(qǐng)選擇所有 Postman，然后選擇所需的范圍。您還可以將搜索范圍更改為工作區(qū)、集合、API或團(tuán)隊(duì)。

對(duì)于未登錄的用戶，搜索結(jié)果僅包括公共資源。

如果在結(jié)果列表中沒(méi)有找到您要查找的內(nèi)容，請(qǐng)選擇搜索所有工作區(qū)、集合、API 和團(tuán)隊(duì)以在一個(gè)頁(yè)面中查看所有結(jié)果。

搜索結(jié)果頁(yè)面列出了范圍和元素類型。您可以更改這些選項(xiàng)以進(jìn)一步過(guò)濾結(jié)果。

您還可以使用右側(cè)的排序依據(jù)對(duì)結(jié)果進(jìn)行排序，方法是選擇最相關(guān)（默認(rèn)）、大多數(shù)視圖或最近。

根據(jù)元素類型，搜索結(jié)果包含不同的信息：

• 對(duì)于workspaces，搜索結(jié)果顯示工作區(qū)類型、摘要、發(fā)布者以及發(fā)布時(shí)間。
• 對(duì)于collections，搜索結(jié)果顯示工作區(qū)類型、集合是否是分支、發(fā)布者以及發(fā)布時(shí)間。
• 對(duì)于API，搜索結(jié)果會(huì)顯示 API 的名稱和摘要、API 的所有者（個(gè)人用戶或團(tuán)隊(duì)）以及工作區(qū)類型。
• 對(duì)于團(tuán)隊(duì)，搜索結(jié)果顯示團(tuán)隊(duì)的名稱和摘要。選擇團(tuán)隊(duì)名稱會(huì)將您重定向到團(tuán)隊(duì)資料。

邊欄

Postman 側(cè)邊欄提供對(duì) Postman 基本元素的訪問(wèn)：

• 收藏品
• 蜜蜂
• 環(huán)境
• 模擬服務(wù)器
• 監(jiān)視器
• 流量
• 歷史

要在邊欄中查看可用于元素的任務(wù)選項(xiàng)，請(qǐng)選擇元素的名稱，然后選擇更多選項(xiàng)圖標(biāo)  。任務(wù)選項(xiàng)將根據(jù)您選擇的元素類型而有所不同。

對(duì)于集合、文件夾和集合中的請(qǐng)求，以及歷史記錄中的請(qǐng)求，您一次可以選擇多個(gè)元素。按住?或Ctrl，然后選擇所需的元素。對(duì)于彼此相鄰的元素，按住Shift鍵，然后選擇所需的元素。對(duì)于集合及其內(nèi)容，您還可以使用鍵盤快捷鍵執(zhí)行復(fù)制、粘貼和刪除等任務(wù)。

 要隱藏邊欄，請(qǐng)從頁(yè)腳中選擇隱藏邊欄圖標(biāo) 。

歷史

要訪問(wèn)您發(fā)出的請(qǐng)求，請(qǐng)?jiān)谶厵谥羞x擇歷史記錄。當(dāng)您登錄到 Postman 時(shí)，您的歷史記錄會(huì)在您的設(shè)備之間同步。

選擇一個(gè)請(qǐng)求以在新選項(xiàng)卡中再次打開(kāi)它。要選擇多個(gè)請(qǐng)求，請(qǐng)按住?或Ctrl，然后選擇請(qǐng)求。

您的歷史記錄還包括收集運(yùn)行。這些保留為運(yùn)行的匯總版本，不會(huì)記錄為單個(gè)請(qǐng)求。

• 選擇添加圖標(biāo)+將請(qǐng)求保存到集合中。
• 選擇刪除圖標(biāo)  以從您的歷史記錄中刪除請(qǐng)求。
• 選擇更多操作圖標(biāo)  以訪問(wèn)其他操作，包括為請(qǐng)求創(chuàng)建監(jiān)視器、文檔或模擬服務(wù)器。

當(dāng)您在共享工作區(qū)中提出請(qǐng)求時(shí)，您可以看到您的請(qǐng)求歷史記錄，但工作區(qū)中的其他團(tuán)隊(duì)成員看不到。

清除你的歷史

 要從歷史記錄中刪除所有請(qǐng)求，請(qǐng)選擇歷史搜索欄旁邊的更多操作圖標(biāo) ，然后選擇全部清除。

在歷史中保存回復(fù)

要在您的歷史記錄中保存請(qǐng)求響應(yīng)，請(qǐng)選擇歷史搜索欄旁邊的更多操作圖標(biāo)  ，然后打開(kāi)保存響應(yīng)。

您不能對(duì)來(lái)自Collection Runner的請(qǐng)求使用Save Responses選項(xiàng)。

工作臺(tái)

無(wú)論您是使用集合、API 還是其他元素類型，Postman 工作臺(tái)都是您完成大部分工作的地方。選項(xiàng)卡使您能夠組織您的工作，而右側(cè)欄使您可以訪問(wèn)特定于元素的工具，例如文檔。環(huán)境選擇器和環(huán)境快速查看使您能夠管理變量。

選項(xiàng)卡

選項(xiàng)卡允許您在請(qǐng)求之間組織和工作。

本節(jié)介紹選項(xiàng)卡在 Postman 桌面應(yīng)用程序中的工作方式。默認(rèn)情況下，Postman Web 應(yīng)用程序中的選項(xiàng)卡也以這種方式工作。您可以選擇使用瀏覽器選項(xiàng)卡，這樣您就可以為每個(gè)打開(kāi)的 Postman 元素使用不同的選項(xiàng)卡。有關(guān)詳細(xì)信息，請(qǐng)參閱Postman Web 應(yīng)用程序中的瀏覽器選項(xiàng)卡。

打開(kāi)一個(gè)新標(biāo)簽

要打開(kāi)新選項(xiàng)卡，請(qǐng)?jiān)诠ぷ髋_(tái)中選擇+ 。

您還可以選擇?+T或Ctrl+T打開(kāi)新選項(xiàng)卡。

如果您打開(kāi)一個(gè)請(qǐng)求但不編輯或發(fā)送它，然后打開(kāi)另一個(gè)請(qǐng)求，第二個(gè)選項(xiàng)卡將替換第一個(gè)選項(xiàng)卡。當(dāng)標(biāo)簽處于預(yù)覽模式時(shí)，它以斜體顯示。

您可以設(shè)置 Postman 是否在新選項(xiàng)卡中打開(kāi)請(qǐng)求。選擇設(shè)置圖標(biāo)  以打開(kāi)“設(shè)置”。在Requests下，選擇Always open requests in a new tab以打開(kāi)或關(guān)閉此選項(xiàng)。

保存或放棄更改

如果選項(xiàng)卡有未保存的更改，Postman 會(huì)在選項(xiàng)卡名稱旁邊顯示一個(gè)點(diǎn)。選擇  保存以保存更改。要關(guān)閉選項(xiàng)卡并放棄更改，請(qǐng)選擇關(guān)閉圖標(biāo)，  然后選擇不保存。

重命名和鏈接元素

要重命名元素，請(qǐng)將鼠標(biāo)懸停在工作臺(tái)中的元素名稱上以顯示編輯圖標(biāo)  。選擇編輯圖標(biāo)并輸入新名稱。

要將鏈接復(fù)制到某個(gè)元素，請(qǐng)將鼠標(biāo)懸停在工作臺(tái)中的元素名稱上以顯示鏈接圖標(biāo)  。選擇鏈接圖標(biāo)將元素的 URL 復(fù)制到剪貼板。

如果該元素位于任何人都無(wú)法訪問(wèn)的個(gè)人工作區(qū)中，則當(dāng)您選擇鏈接圖標(biāo)時(shí)將顯示一個(gè)彈出窗口。彈出窗口使您能夠在共享鏈接之前邀請(qǐng)其他人到您的個(gè)人工作區(qū)。要邀請(qǐng)他人加入您的個(gè)人工作區(qū)，請(qǐng)選擇邀請(qǐng)他人。要了解有關(guān)邀請(qǐng)人們?cè)诠ぷ鲄^(qū)中進(jìn)行協(xié)作的更多信息，請(qǐng)參閱共享工作區(qū)。

查看沖突

如果您或協(xié)作者在另一個(gè)選項(xiàng)卡或工作區(qū)中更改其內(nèi)容，選項(xiàng)卡將提醒您存在沖突。Postman 會(huì)提示您解決發(fā)生的任何沖突。

管理選項(xiàng)卡

您可以同時(shí)打開(kāi)多個(gè)選項(xiàng)卡。要重新排列打開(kāi)的選項(xiàng)卡，請(qǐng)按所需順序選擇并拖動(dòng)它們。

要管理打開(kāi)的選項(xiàng)卡或訪問(wèn)最近關(guān)閉的選項(xiàng)卡，請(qǐng)選擇更多操作圖標(biāo)  以打開(kāi)包含操作選項(xiàng)的菜單：

• 最近關(guān)閉的選項(xiàng)卡- 顯示您最近關(guān)閉的選項(xiàng)卡。選擇一個(gè)以重新打開(kāi)它。
• 復(fù)制選定的選項(xiàng)卡- （僅限桌面應(yīng)用程序）復(fù)制當(dāng)前選項(xiàng)卡。這不會(huì)創(chuàng)建請(qǐng)求的副本，因此當(dāng)您復(fù)制選項(xiàng)卡時(shí)，您所做的任何編輯都會(huì)反映在原始請(qǐng)求中。
• 關(guān)閉選定選項(xiàng)卡- 關(guān)閉當(dāng)前選項(xiàng)卡。如果選項(xiàng)卡有未保存的更改，Postman 會(huì)在關(guān)閉前詢問(wèn)您是否要保存。
• Force Close Selected Tab - 關(guān)閉當(dāng)前選項(xiàng)卡而不保存任何更改。
• 關(guān)閉除選定選項(xiàng)卡之外的所有選項(xiàng)卡- 關(guān)閉除您正在使用的選項(xiàng)卡之外的所有選項(xiàng)卡。
• 關(guān)閉所有選項(xiàng)卡- 關(guān)閉所有選項(xiàng)卡。如果任何選項(xiàng)卡包含未保存的更改，Postman 將在關(guān)閉前詢問(wèn)您是否要保存。
• 強(qiáng)制關(guān)閉所有選項(xiàng)卡- 關(guān)閉所有選項(xiàng)卡而不保存任何更改。

您還可以通過(guò)右鍵單擊現(xiàn)有選項(xiàng)卡來(lái)管理打開(kāi)的選項(xiàng)卡或打開(kāi)新選項(xiàng)卡。

關(guān)閉未保存的選項(xiàng)卡。您可以設(shè)置 Postman 是否在您關(guān)閉有更改的選項(xiàng)卡時(shí)詢問(wèn)您是否要保存。選擇設(shè)置圖標(biāo)  以打開(kāi)“設(shè)置”。在Requests下，選擇Always ask when closing unsaved tabs以打開(kāi)或關(guān)閉此選項(xiàng)。

如果您打開(kāi)了很多選項(xiàng)卡，它們可能會(huì)溢出選項(xiàng)卡欄的區(qū)域。要轉(zhuǎn)到可視區(qū)域之外的選項(xiàng)卡，請(qǐng)選擇選項(xiàng)卡欄旁邊的箭頭。

Postman Web 應(yīng)用程序中的瀏覽器選項(xiàng)卡

默認(rèn)情況下，Postman 網(wǎng)絡(luò)應(yīng)用程序使用應(yīng)用程序內(nèi)選項(xiàng)卡，就像 Postman 桌面應(yīng)用程序一樣。您可以選擇改用瀏覽器選項(xiàng)卡。啟用此設(shè)置后，主工作區(qū)中一次只有一個(gè)集合概覽或請(qǐng)求，您可以在新的瀏覽器選項(xiàng)卡中打開(kāi)更多 Postman 元素。這使您能夠跨工作區(qū)工作或在同一工作區(qū)中使用不同的環(huán)境。

如果您已保存對(duì)請(qǐng)求的更改，當(dāng)您選擇一個(gè)新元素時(shí)，Postman 將在主工作區(qū)中打開(kāi)它。如果請(qǐng)求有未保存的更改，Postman 將提示您保存或放棄您的更改。

要在新的瀏覽器選項(xiàng)卡中打開(kāi)工作區(qū)、環(huán)境或請(qǐng)求，請(qǐng)按住?+Shift或Ctrl+Shift并選擇要打開(kāi)的元素。

要在新的瀏覽器選項(xiàng)卡中打開(kāi)應(yīng)用內(nèi)鏈接，請(qǐng)按住?或Ctrl并選擇要打開(kāi)的鏈接。

 要在 Postman Web 應(yīng)用程序中打開(kāi)或關(guān)閉此行為，請(qǐng)選擇標(biāo)題中的設(shè)置圖標(biāo) ，然后選擇用戶界面部分中的刪除選項(xiàng)卡。

右側(cè)邊欄

根據(jù)您選擇的 Postman 元素類型，右側(cè)欄可讓您訪問(wèn)更多工具，包括文檔、評(píng)論、代碼片段和請(qǐng)求信息。

工具	可以用來(lái)	描述
文檔	集合、請(qǐng)求	請(qǐng)參閱集合或特定請(qǐng)求的文檔。
評(píng)論	集合、請(qǐng)求、API	對(duì)請(qǐng)求或 API 的特定部分留下評(píng)論。
代碼	請(qǐng)求、API、歷史	生成可在其他應(yīng)用程序中使用的各種語(yǔ)言和框架的代碼片段。
現(xiàn)場(chǎng)收藏	收藏品	使用Live Collections根據(jù)您的應(yīng)用程序使集合保持最新。
相關(guān)合集	請(qǐng)求，歷史	查看來(lái)自公共 API 網(wǎng)絡(luò)的公共集合，這些集合與您的請(qǐng)求共享相同的基本 URL 并包含 API 文檔。
信息	集合、請(qǐng)求、API、環(huán)境、模擬服務(wù)器、監(jiān)視器、流	查看有關(guān)元素的詳細(xì)信息，包括其 ID、創(chuàng)建時(shí)間、創(chuàng)建者等。
變更日志	集合、API	使用變更日志查看您和您的合作者所做的更改。適用于Postman 付費(fèi)計(jì)劃。
拉取請(qǐng)求	集合、環(huán)境	查看Postman 元素的任何拉取請(qǐng)求。
叉子	集合、環(huán)境、流	查看Postman 元素的任何分支。
活動(dòng)提要	監(jiān)視器	查看監(jiān)視器的活動(dòng)源。
流元素信息	流量	查看所選塊的輸入和輸出。
發(fā)布版本	流量	查看您發(fā)布的流量。
執(zhí)行問(wèn)題	流量	查看流的執(zhí)行問(wèn)題（如果有）。

環(huán)境選擇器和環(huán)境快速查看

環(huán)境選擇器使您能夠選擇要在您的工作中使用的環(huán)境。從菜單中選擇一個(gè)環(huán)境以將其設(shè)置為活動(dòng)環(huán)境，這樣您就可以訪問(wèn)該環(huán)境中的變量。

要一目了然地檢查變量值，請(qǐng)使用環(huán)境快速查看圖標(biāo)  。

頁(yè)腳

Postman 底部的頁(yè)腳使您能夠查找和替換文本、打開(kāi)控制臺(tái)、捕獲請(qǐng)求和 cookie，以及訪問(wèn)其他幾個(gè)工具。

•  隱藏邊欄- 關(guān)閉或重新打開(kāi)邊欄。
•  同步狀態(tài)- 查看您是否已連接到 Postman 的服務(wù)器以及您的數(shù)據(jù)是否正在同步。
•  查找和替換- （僅限 Postman 桌面應(yīng)用程序）搜索當(dāng)前工作區(qū)。您還可以使用快捷鍵?+Shift+F或Ctrl+Shift+F。輸入您的搜索字符串，然后選擇“查找”。通過(guò)選擇Collections、Environments、Globals或Open tabs將您的搜索限制在特定的元素類型。要替換所選元素中的搜索詞，請(qǐng)選擇替換為所選元素。
•  控制臺(tái)-檢查和調(diào)試您的 Postman 請(qǐng)求。

•  Git 分支圖標(biāo)- 對(duì)于使用 Git 存儲(chǔ)庫(kù)的 API，切換分支并打開(kāi)源代碼管理窗格。
•  Cookies - 查看、管理和同步cookies。
•  捕獲請(qǐng)求- 啟動(dòng)Postman 代理或攔截器會(huì)話。
•  Runner - 打開(kāi)Collection Runner。
•  垃圾桶- 恢復(fù)或永久刪除任何已刪除的收藏。
•  雙窗格視圖- 在單窗格視圖和雙窗格視圖之間切換。
•  幫助- 訪問(wèn)更多資源，包括發(fā)行說(shuō)明和 Postman 支持。