Postman 使用集合

您可以將您的 Postman 請(qǐng)求和示例分組到集合中，以保持您的工作空間井然有序、與團(tuán)隊(duì)成員協(xié)作、生成 API 文檔和 API 測(cè)試以及自動(dòng)執(zhí)行請(qǐng)求運(yùn)行。

在側(cè)邊欄中選擇集合以獲取工作區(qū)中的集合列表。

創(chuàng)建集合

有幾種創(chuàng)建新集合的方法：

• 在邊欄中選擇收藏，然后選擇+。
• 選擇新建，然后選擇收藏。
• 在左側(cè)邊欄中打開收藏后，選擇+。
• 在空工作區(qū)中，選擇Create Collection。
• 您還可以從模板創(chuàng)建集合。

要自定義和配置新集合，請(qǐng)執(zhí)行以下操作：

1. 選擇編輯圖標(biāo)  為您的新收藏命名。
2. 您可以選擇為您的收藏指定描述。選擇文檔圖標(biāo)  ，然后選擇編輯圖標(biāo)  來編寫您的描述。當(dāng)任何人打開它時(shí)，此描述將出現(xiàn)在其文檔和工作區(qū)中。
3. 選擇授權(quán)以配置集合的授權(quán)詳細(xì)信息。
4. 選擇預(yù)請(qǐng)求腳本為您的集合定義一個(gè)預(yù)請(qǐng)求腳本，該腳本將在請(qǐng)求發(fā)送到服務(wù)器之前運(yùn)行。
5. 選擇測(cè)試為您的集合定義測(cè)試腳本，該腳本將在收到響應(yīng)后運(yùn)行。
6. 選擇變量以定義集合變量的值以在集合中的所有請(qǐng)求之間共享。

將請(qǐng)求添加到集合

有幾種方法可以將現(xiàn)有的和新的請(qǐng)求添加到集合中。

將現(xiàn)有請(qǐng)求移動(dòng)到不同的集合

要將現(xiàn)有請(qǐng)求移動(dòng)到不同的集合，請(qǐng)執(zhí)行以下操作：

1. 選擇您要移動(dòng)的請(qǐng)求。
2. 將請(qǐng)求拖到所需的集合中。

或者，打開請(qǐng)求并選擇另存為，然后選擇要將其移動(dòng)到的集合。

要將多個(gè)請(qǐng)求移動(dòng)到不同的集合，請(qǐng)執(zhí)行以下操作：

1. 按住?或Ctrl，然后選擇要移動(dòng)的請(qǐng)求。
2. 將請(qǐng)求拖到所需的集合中。

向集合添加新請(qǐng)求

1. 從新請(qǐng)求中，選擇保存。
2. 選擇要將其移動(dòng)到的集合，然后選擇保存。
3. 要?jiǎng)?chuàng)建一個(gè)新的集合來保存請(qǐng)求，請(qǐng)選擇New Collection。

在集合中創(chuàng)建新請(qǐng)求

1.  選擇集合名稱旁邊的更多操作圖標(biāo) 。
2. 從操作菜單中選擇添加請(qǐng)求。

或者，選擇新建，然后選擇請(qǐng)求。

向空集合添加請(qǐng)求

選擇集合，然后選擇添加請(qǐng)求。

將歷史記錄中的請(qǐng)求添加到集合中

1. 在邊欄中選擇歷史記錄。
2.  選擇要保存的請(qǐng)求旁邊的更多操作圖標(biāo) 。
3. 選擇保存請(qǐng)求。
4. 選擇要將請(qǐng)求添加到的集合，然后選擇保存。

或者，選擇請(qǐng)求旁邊的+ 。

管理集合

基本動(dòng)作

從工作區(qū)的集合列表中，您可以：

• 選擇一個(gè)集合以在選項(xiàng)卡中打開其概覽。
• 通過選擇集合名稱旁邊的箭頭打開和關(guān)閉集合內(nèi)容。
• 將鼠標(biāo)懸停在集合名稱上并選擇星形圖標(biāo) ★ 將該集合移至列表頂部。
• 使用集合搜索欄篩選您的集合。
• 通過拖放對(duì)集合中的請(qǐng)求、文件夾和示例進(jìn)行重新排序。

將文件夾添加到集合

1.  選擇集合名稱旁邊的更多操作圖標(biāo) 。
2. 選擇添加文件夾。

您還可以添加子文件夾來為集合的請(qǐng)求和示例創(chuàng)建額外的嵌套級(jí)別。

刪除集合

1.  選擇集合名稱旁邊的更多操作圖標(biāo) 。
2. 選擇刪除。

您還可以選擇收藏集，然后按鍵盤上的Delete 鍵。

如果刪除的收藏集大于 30 MB，您將無法恢復(fù)它。為避免這種情況，您可以在刪除集合之前將其拆分為更小的部分，或者先備份集合。

恢復(fù)已刪除的集合

1.  選擇集合搜索欄旁邊的更多操作圖標(biāo) 。
2. 選擇打開垃圾箱?；蛘?， 從 Postman 頁腳中選擇 垃圾桶。
3.  在“垃圾箱”頁面中，選擇要恢復(fù)的集合旁邊的恢復(fù)圖標(biāo) 。

無法恢復(fù)大于 30 MB 的已刪除集合。

恢復(fù)選項(xiàng)取決于您的 Postman 計(jì)劃：

• 免費(fèi)帳戶：恢復(fù)收藏最多一天。
• Postman Basic：恢復(fù)收藏長達(dá) 30 天。
• Postman Professional 和 Enterprise：恢復(fù)收藏長達(dá) 90 天。

如果您希望位于廢紙簍中的集合不存在，則它可能已從工作區(qū)中移除，而不是被刪除。如果集合出現(xiàn)在另一個(gè)工作區(qū)中，您可以通過選擇共享來移動(dòng)它。

分享收藏

要與其他用戶共享集合，您可以：

• 在 Postman 按鈕中發(fā)布運(yùn)行。
•  通過選擇集合名稱旁邊的更多操作圖標(biāo) ，然后選擇共享，邀請(qǐng)其他人進(jìn)行協(xié)作。了解有關(guān)在 Postman 中共享元素的更多信息。
• 允許不在您的 Postman 團(tuán)隊(duì)中的外部用戶查看集合，方法是選擇  集合名稱旁邊的更多操作圖標(biāo)，選擇Share，然后打開 Allow Guests 旁邊的開關(guān)，并提供加入您的團(tuán)隊(duì)和查看集合的鏈接。了解有關(guān)允許外部用戶查看集合的更多信息。
•  通過選擇集合名稱旁邊的更多操作圖標(biāo)，然后選擇移動(dòng)將集合移動(dòng)到共享工作區(qū) 。了解有關(guān)移動(dòng) Postman 元素的更多信息。
• （企業(yè)）將集合添加到您團(tuán)隊(duì)的私有 API 網(wǎng)絡(luò)。

看一個(gè)集合

當(dāng)您查看集合時(shí)，Postman 會(huì)在工作區(qū)團(tuán)隊(duì)成員對(duì)集合進(jìn)行更改時(shí)通知您，包括添加新請(qǐng)求、修改現(xiàn)有請(qǐng)求、添加或更新變量、編輯請(qǐng)求前腳本或測(cè)試以及添加或刪除文件夾. 您可以觀看您擁有的收藏集，也可以觀看任何公共工作區(qū)中的收藏集。

要觀看集合，請(qǐng)執(zhí)行以下操作：

1. 選擇觀看圖標(biāo)  開始觀看收藏。

要查看有關(guān)您觀看的集合中發(fā)生的更改的通知，請(qǐng)執(zhí)行以下操作：

1. 選擇 Postman 標(biāo)題中的通知圖標(biāo)  以查看通知。選擇查看更改日志以查看集合的更改日志。
2. 您還將收到一封電子郵件，其中包含有關(guān)更改人、更改內(nèi)容以及更改時(shí)間的信息。在電子郵件中選擇查看更改日志以訪問 Postman 中的完整更改日志。

如果您創(chuàng)建一個(gè)集合并從同一個(gè) Postman 帳戶更改它，您將不會(huì)收到您對(duì)該集合所做的任何更改的通知。

分叉一個(gè)集合

您可以在自己的工作區(qū)中派生集合來開發(fā)集合版本。

1.  選擇集合名稱旁邊的更多操作圖標(biāo) 。
2. 選擇分叉。

 或者，從集合概覽中選擇分叉圖標(biāo) 。

向集合添加評(píng)論

1.  從右側(cè)邊欄中選擇評(píng)論圖標(biāo) 。
2. 寫下您的評(píng)論，然后選擇添加評(píng)論。

還原集合更改

要將您的收藏恢復(fù)到較早的狀態(tài)，請(qǐng)執(zhí)行以下操作：

1.  選擇右側(cè)的更改日志圖標(biāo) 。
2. 選擇一個(gè)會(huì)話以展開它。
3.  選擇要將收藏集恢復(fù)到的更改旁邊的更多操作圖標(biāo) ，然后選擇恢復(fù)到此更改。

從更改日志中恢復(fù)集合會(huì)將其恢復(fù)到您選擇的更改發(fā)生后的狀態(tài)。

查看拉取請(qǐng)求、分叉和集合詳細(xì)信息

從右側(cè)邊欄：

• 要查看集合的拉取請(qǐng)求，請(qǐng)選擇拉取請(qǐng)求圖標(biāo) 
• 要查看從集合創(chuàng)建的分叉，請(qǐng)選擇分叉圖標(biāo) 
• 要查看有關(guān)集合的更多信息，包括模擬服務(wù)器、監(jiān)視器和集成，請(qǐng)選擇信息圖標(biāo) 

在開發(fā)工作流程中使用集合

集合可以為 API 開發(fā)、測(cè)試和發(fā)布工作流的各個(gè)部分提供支持。

• 選擇Run以訪問Collection Runner，它允許您運(yùn)行集合中的所有請(qǐng)求并將測(cè)試工作流構(gòu)建到您的運(yùn)行中。
• 選擇文檔圖標(biāo) 以從集合中 生成API 文檔。
• 將監(jiān)視器附加到集合可讓您安排集合運(yùn)行。選擇集合名稱旁邊的更多操作圖標(biāo)  ，然后選擇監(jiān)控集合。
• 您可以使用模擬服務(wù)器在測(cè)試和開發(fā)期間返回示例數(shù)據(jù)。選擇集合名稱旁邊的更多操作圖標(biāo)  ，然后選擇模擬集合。
• 使用Postman API Builder根據(jù) API 規(guī)范生成集合。

使用集合模板

創(chuàng)建收藏集時(shí)不確定從哪里開始？您可以從模板創(chuàng)建集合，而不是從頭開始。有幾個(gè)集合模板可用于開始集成、API 文檔、條件工作流或數(shù)據(jù)可視化。

有幾種方法可以從模板創(chuàng)建集合：

• 首次創(chuàng)建帳戶時(shí)，系統(tǒng)會(huì)詢問您是否要從模板創(chuàng)建集合。
• 在空白工作區(qū)的左側(cè)邊欄中，選擇“使用模板”。
• 選擇新建，然后選擇使用模板。

關(guān)于多協(xié)議請(qǐng)求集合

您還可以將多協(xié)議請(qǐng)求（例如WebSocket和gRPC請(qǐng)求）保存到集合中。

由于多協(xié)議請(qǐng)求與 HTTP 請(qǐng)求具有不同的特性，因此當(dāng)它們被保存到一個(gè)集合中時(shí)，它會(huì)導(dǎo)致該集合處于具有某些限制的“測(cè)試版”狀態(tài)。

處于此狀態(tài)時(shí)，集合只能包含 WebSocket 或 gRPC 請(qǐng)求，而不能包含 HTTP 請(qǐng)求。也不支持與集合相關(guān)的一些功能。