Postman 接收響應(yīng)

Postman 響應(yīng)查看器可幫助您可視化并檢查 API 響應(yīng)的正確性。API 響應(yīng)由響應(yīng)主體、標(biāo)頭和 HTTP 狀態(tài)代碼組成。

響應(yīng)體

Postman Body選項(xiàng)卡為您提供了多種工具來幫助您快速理解響應(yīng)。您可以在四種視圖之一中查看正文：Pretty、Raw、Preview和Visualize。

在響應(yīng)中查找項(xiàng)目- 要打開搜索欄，請選擇  結(jié)果窗格中的搜索圖標(biāo)。您還可以將光標(biāo)放在響應(yīng)中并選擇?+F或Ctrl+F。此選項(xiàng)在響應(yīng)的預(yù)覽或可視化視圖中不可用。

請注意，如果響應(yīng)的Content-Type標(biāo)頭指示響應(yīng)是圖像，Postman 將自動檢測并呈現(xiàn)圖像。

漂亮的

Pretty 視圖格式化 JSON 或 XML 響應(yīng)，以便它們更易于查看。Pretty 視圖中的鏈接被突出顯示，選擇它們可以在 Postman 中加載帶有鏈接 URL 的 GET 請求。

要導(dǎo)航大型響應(yīng)，請選擇一行旁邊的向下箭頭以折疊響應(yīng)的大部分。

強(qiáng)制 JSON 格式化。為了使 Postman 自動格式化正文，響應(yīng)必須具有適當(dāng)?shù)腃ontent-Type標(biāo)頭。如果您收到帶有不同標(biāo)頭的響應(yīng)Content-Type，您可以通過 JSON 強(qiáng)制格式化。在 Postman 標(biāo)題中，選擇設(shè)置圖標(biāo)  ，然后選擇設(shè)置。在常規(guī)選項(xiàng)卡中，從語言檢測下拉列表中選擇JSON。

生的

Raw 視圖是一個(gè)帶有響應(yīng)正文的大文本區(qū)域。它可以指示您的響應(yīng)是否被縮小。

預(yù)覽

預(yù)覽視圖在沙盒 iframe 中呈現(xiàn)響應(yīng)。某些 Web 框架默認(rèn)返回 HTML 錯(cuò)誤，在這些情況下，預(yù)覽對于調(diào)試特別有用。

由于 iframe 沙盒限制，JavaScript 和圖像在 iframe 中被關(guān)閉。對于二進(jìn)制響應(yīng)類型，您可以選擇“發(fā)送并下載”以將響應(yīng)保存在本地。然后您可以使用適當(dāng)?shù)牟榭雌鞑榭此?。這使您可以靈活地測試音頻文件、PDF、zip 文件或 API 返回的任何其他文件類型。

可視化

可視化視圖根據(jù)您添加到請求測試中的可視化代碼呈現(xiàn) API 響應(yīng)中的數(shù)據(jù)。有關(guān)如何添加、使用和調(diào)試可視化代碼的詳細(xì)信息，請參閱可視化響應(yīng)。

餅干

您可以在Cookies選項(xiàng)卡中檢查服務(wù)器發(fā)送的 cookies 。cookie 的條目包括其名稱、值、關(guān)聯(lián)域和路徑以及有關(guān) cookie 的其他信息。

要了解有關(guān)在 Postman 中使用 cookie 的更多信息，請參閱 使用 cookie。

標(biāo)頭

標(biāo)頭在“標(biāo)頭”選項(xiàng)卡下顯示為鍵值對。將鼠標(biāo)懸停在標(biāo)頭名稱旁邊的信息圖標(biāo)上  ，以根據(jù) HTTP 規(guī)范獲取標(biāo)頭的描述。

如果您發(fā)送 HEAD 請求，Postman 將默認(rèn)顯示Headers選項(xiàng)卡而不是Body選項(xiàng)卡。

檢測結(jié)果

如果您正在查看的 API 請求有任何測試腳本，結(jié)果將顯示在“測試結(jié)果”選項(xiàng)卡中。

要了解有關(guān)在 Postman 中針對 API 請求運(yùn)行測試的更多信息，請參閱編寫測試。

網(wǎng)絡(luò)信息

當(dāng)您的 API 返回響應(yīng)時(shí)，Postman 會顯示網(wǎng)絡(luò)信息。將鼠標(biāo)懸停在網(wǎng)絡(luò)圖標(biāo)上  以獲取您發(fā)送的請求的本地和遠(yuǎn)程 IP 地址。

當(dāng)您發(fā)出https請求時(shí)，網(wǎng)絡(luò)圖標(biāo)包含一個(gè)掛鎖。當(dāng)您將鼠標(biāo)懸停在該圖標(biāo)上時(shí)，網(wǎng)絡(luò)信息將顯示更多信息，包括證書驗(yàn)證詳細(xì)信息。

SSL 驗(yàn)證錯(cuò)誤

如果你在 Postman 的全局設(shè)置中開啟了 SSL 驗(yàn)證，驗(yàn)證失敗，響應(yīng)區(qū)會顯示錯(cuò)誤信息。選擇錯(cuò)誤消息中的鏈接以全局關(guān)閉驗(yàn)證并立即再次運(yùn)行請求。

如果 SSL 全局關(guān)閉但針對您的請求打開，Postman 會顯示錯(cuò)誤并為您提供打開控制臺的鏈接。

如果您在錯(cuò)誤消息中選擇禁用 SSL 驗(yàn)證，如果您想要驗(yàn)證證書以供將來請求使用，則需要將其重新打開。 要全局啟用它，請選擇標(biāo)題中的設(shè)置圖標(biāo) ，然后選擇設(shè)置。在常規(guī)選項(xiàng)卡中，選擇SSL 證書驗(yàn)證。

要僅為當(dāng)前請求啟用 SSL 驗(yàn)證，請選擇請求中的設(shè)置選項(xiàng)卡，然后選擇啟用 SSL 證書驗(yàn)證。

如果您關(guān)閉了SSL 驗(yàn)證并且您的請求返回證書驗(yàn)證錯(cuò)誤，您可以將鼠標(biāo)懸停在網(wǎng)絡(luò)信息上以獲取有關(guān)錯(cuò)誤的詳細(xì)信息。

對于返回?cái)?shù)據(jù)成功但證書驗(yàn)證失敗的請求，控制臺會顯示警告。

響應(yīng)碼

Postman 顯示 API 返回的響應(yīng)代碼。將鼠標(biāo)懸停在響應(yīng)代碼上以獲得代碼的簡短描述及其含義。

一些 API 響應(yīng)還包含可幫助您理解響應(yīng)代碼的自定義消息。例如，如果您收到401 Unauthorized響應(yīng)，該消息可能會告訴您檢查您在請求中使用的令牌。如果返回自定義消息，它們將顯示在響應(yīng)的正文中。

響應(yīng)時(shí)間

Postman 自動計(jì)算響應(yīng)從服務(wù)器到達(dá)所需的時(shí)間（以毫秒為單位）。此信息可用于某些初步性能測試。將鼠標(biāo)懸停在圖表的響應(yīng)時(shí)間上，其中包含有關(guān)流程中每個(gè)事件花費(fèi)多長時(shí)間的信息。

響應(yīng)大小

Postman 顯示響應(yīng)的大致大小。將鼠標(biāo)懸停在響應(yīng)大小上以按正文和標(biāo)題大小進(jìn)行細(xì)分。

保存回復(fù)

如果請求已保存在集合中，您可以保存該請求的響應(yīng)。返回響應(yīng)后，您可以：

• 選擇另存為示例以將響應(yīng)保存為您可以稍后訪問的示例。
• 選擇更多操作圖標(biāo)  ，然后選擇將響應(yīng)保存到文件以將響應(yīng)保存為 JSON 文件。
• 選擇更多操作圖標(biāo)  ，然后 選擇清除響應(yīng)以刪除響應(yīng)查看器中的所有數(shù)據(jù)。請注意，對于基于事件的請求，這僅在流關(guān)閉后可用。

查看安全警告

當(dāng)您使用 Postman Web 應(yīng)用程序或 Postman 桌面應(yīng)用程序向任何 API 發(fā)送請求時(shí)，Postman 會應(yīng)用為您的API 請求配置的安全規(guī)則。安全警告表示 API 可能存在潛在的安全風(fēng)險(xiǎn)，但并不意味著 API 已損壞。

要查看 Postman 應(yīng)用于所有請求的特定安全警告，請參閱安全警告。

如果發(fā)現(xiàn)任何潛在的安全風(fēng)險(xiǎn)，Postman 會將警告數(shù)量添加到響應(yīng)中的“安全”選項(xiàng)卡。

要查看安全警告列表并獲取有關(guān)特定警告的更多信息，請執(zhí)行以下操作：

1. 選擇安全以查看警告。
2. 有關(guān)更多詳細(xì)信息，請選擇一個(gè)警告以將其展開。
3. 選擇可能的修復(fù)以了解解決潛在問題的可能方法。

隱藏安全警告

要關(guān)閉當(dāng)前 API 響應(yīng)的警告，請執(zhí)行以下操作：

1. 選擇隱藏警告。
2. 選擇隱藏它的原因，然后選擇隱藏。

這將為您團(tuán)隊(duì)的所有成員關(guān)閉警告，但僅限于此響應(yīng)。

要為您的團(tuán)隊(duì)全局關(guān)閉警告，您可以配置 API 安全規(guī)則（僅適用于企業(yè)團(tuán)隊(duì)）。

當(dāng)您或您團(tuán)隊(duì)的其他成員隱藏警告時(shí)，Postman 會在“安全”選項(xiàng)卡中顯示一條消息，指示隱藏了多少警告。

要稍后重新打開此警告，請執(zhí)行以下操作：

1. 選擇審查。
2. 查看隱藏的警告并選擇  要重新打開的警告旁邊的眼睛圖標(biāo)。