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)卡為您提供了多種工具來(lái)幫助您快速理解響應(yīng)。您可以在四種視圖之一中查看正文：Pretty、Raw、Preview和Visualize。

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

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

漂亮的

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

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

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

生的

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

預(yù)覽

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

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

可視化

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

餅干

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

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

標(biāo)頭

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

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

檢測(cè)結(jié)果

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

要了解有關(guān)在 Postman 中針對(duì) API 請(qǐng)求運(yùn)行測(cè)試的更多信息，請(qǐng)參閱編寫(xiě)測(cè)試。

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

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

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

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

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

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

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

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

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

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

響應(yīng)碼

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

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

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

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

響應(yīng)大小

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

保存回復(fù)

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

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

查看安全警告

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

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

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

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

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

隱藏安全警告

要關(guān)閉當(dāng)前 API 響應(yīng)的警告，請(qǐ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 會(huì)在“安全”選項(xiàng)卡中顯示一條消息，指示隱藏了多少警告。

要稍后重新打開(kāi)此警告，請(qǐng)執(zhí)行以下操作：

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