[TOC] ## REQUEST 在構建請求時，您將與請求主體編輯器一起工作。Postman可以發送幾乎任何類型的HTTP請求。身體編輯器分為4個區域，根據身體類型有不同的控制。 關于標題的注意事項：當您通過HTTP協議發送請求時，您的服務器可能會期待一個Content-Type頭。Content-Type頭允許服務器正確解析正文。對于表單數據和urlencoded主體類型，Postman會自動附加正確的Content-Type頭，因此您不必設置它。當您選擇格式化類型時，將設置原始模式標題。如果您手動使用Content-Type標頭，則該值優先于Postman設置。Postman沒有為二進制體類型設置任何頭類型。 ### Builder 在“?Builder”選項卡下，請求構建器允許您快速創建任何類型的HTTP請求。HTTP請求的四個部分是URL，方法，標頭和主體。PostMan為您提供工具來處理這些部分。 URL是您為請求設置的第一件事。URL輸入字段存儲先前使用的URL，并在您開始輸入URL時顯示自動完成下拉列表。 單擊 Params按鈕打開用于輸入URL參數的數據編輯器。您可以單獨添加鍵值對，Postman將組合上述查詢字符串中的所有內容。如果您的網址已經具有參數 - 例如，如果您粘貼了其他來源的網址，Postman會將網址自動分割成對。 >[warning] 您在URL欄或數據編輯器中輸入的參數不會自動進行URL編碼。右鍵單擊所選文本，然后選擇“EncodeURIComponent”手動編碼參數值。 >[warning] http://如果沒有指定協議， Postman將自動添加到URL的開頭。 ### Cookie 可以使用Cookie管理器編輯與每個域相關聯的Cookie，可以在本機應用程序中管理Cookie。要打開模式，請單擊??發送??按鈕?下的Cookies 鏈接??。進一步了解如何管理Cookie。  ### Header presets 您可以在標題預設中將常用標題保存在一起。根據頭選項卡，您可以通過選擇“Manager presets”從頭預設添加到您的請求預設右側下拉列表。  ### Headers 單擊標題選項卡將顯示標題鍵值編輯器。您可以將任何字符串設置為頭名稱。自動完成下拉列表將在您輸入字段時提供常見HTTP標頭的建議。“Content-Type”標題的值也可以在自動完成的下拉列表中使用。  ### Method 使用控件下拉列表可以直接更改請求方法。請求Body編輯器區域將根據方法是否可以附加Body而改變。  ### 請求體（Url & Body） 在構建請求時，您將與請求主體編輯器一起工作。Postman可以發送幾乎任何類型的HTTP請求。Body編輯器分為4個區域，根據身體類型有不同的控制。 關于標題的注意事項：當您通過HTTP協議發送請求時，您的服務器可能會期待一個Content-Type頭。Content-Type頭允許服務器正確解析正文。對于表單數據和urlencoded主體類型，Postman會自動附加正確的Content-Type頭，因此您不必設置它。當您選擇格式化類型時，將設置原始模式標題。如果您手動使用Content-Type標頭，則該值優先于Postman設置。Postman沒有為二進制體類型設置任何頭類型。 * Form-data multipart/form-data是Web表單用于傳輸數據的默認編碼。這樣可以模擬在網站上填寫表單，并提交表單。表單數據編輯器可以為數據設置鍵值對（使用數據編輯器）。您也可以將文件附加到密鑰。注意：由于HTML 5規范的限制，文件不會存儲在歷史記錄或集合中。下次發送請求時，您將需要再次選擇該文件。 不支持使用自己的Content-Type上載多個文件。  * xxx-www-form-urlencode 此編碼與URL參數中使用的編碼相同。您只需要輸入鍵值對，Postman會正確地對鍵和值進行編碼。請注意，您無法通過此編碼模式上傳文件。形式數據和urlencoded之間可能會有一些混淆，所以請務必先檢查一下你的API。 * RAW 原始請求可以包含任何內容。除了替換環境變量，PostMan不會觸及在原始編輯器中輸入的字符串。無論您放在文本區域中是否發送請求。原始編輯器可讓您設置格式化類型以及您應該使用原始主體發送的正確標題。您也可以手動設置Content-Type標題，這將覆蓋Postman定義的設置。在編輯器類型中選擇XML / JSON可以為您的請求體提供語法突出顯示，并設置Content-Type頭。 提示：?在編輯器中選擇文本并按CMD / CTRL + B?可以自動對XML / JSON內容進行美化。  * Binary 二進制數據允許您發送無法在Postman中輸入的內容，例如圖像，音頻或視頻文件。您也可以發送文本文件。如前面在表單數據部分所述，如果要通過歷史記錄或集合加載請求，則必須重新連接文件。  ## RESPONSE 確保API響應正確是您在使用API??時會做很多工作。Postman回復查看器將使您的這個任務更容易。 API響應由主體，標題和狀態代碼組成。PostMan在不同的標簽中組織正文和標題。狀態代碼與完成API調用所需的時間一起顯示在選項卡旁邊。您可以將鼠標懸停在狀態代碼上，以獲取有關代碼的更多詳細信息。大多數情況下，它將是HTTP規范規定的默認描述，但是API作者也可以添加自定義消息。 * Save Response 如果請求已保存在集合中，則可以保存該請求的響應。一旦返回響應，單擊保存響應按鈕。輸入名稱以呼叫保存的響應。保存在請求中的所有響應將在您加載請求時作為example提供。單擊右上角的“?examples”下拉列表以查看并選擇保存的示例。這兒別的人員才查看時，可以方便的知道每種情況不同的響應內容。  * 查看Response PostMan Body標簽為您提供了幾個工具來幫助您快速了解事物。Body可以在三個視圖中看到 - Pretty，Raw和Preview。  * Pretty Pretty的模式可以格式化JSON或XML響應，以便更容易查看。沒有人想滾動一個最小的單行JSON響應尋找那個難以捉摸的字符串！突出顯示漂亮模式中的鏈接，點擊它們可以使用鏈接URL在Postman中加載GET請求。對于導航大響應，單擊左側的向下三角形（▼）以折疊大部分響應。 * Raw 原始視圖只是一個響應體的大文本區域。它可以幫助您判斷您的響應是否縮小。 * Preview 預覽選項卡會在沙盒iframe中呈現響應。一些Web框架默認情況下返回HTML錯誤，預覽模式在這里特別有用。由于iframe沙盒限制，JavaScript和圖像在iframe中被禁用。 您可以最大化body占據整個postman窗口。如果你打算花費大量的時間來應對這個問題，那就是要走的路。 如果您的API端點返回圖像，Postman將自動檢測并呈現。對于二進制響應類型，您應該選擇“Send and download”，這將使您將響應保存到硬盤。然后，您可以使用適當的查看器查看它。這使您可以靈活地測試音頻文件，PDF，zip文件或API拋出的任何內容。 ## Cookie Postman的本機應用程序提供 `MANAGE COOKIES` 模式，允許您編輯與每個域關聯的Cookie。 如果您在Postman Chrome應用程序中工作，可以使用`Interceptor`擴展來幫助管理Cookie。 ## Tests 除了從請求的服務器獲得的所有內容之外，還可以查看針對請求運行的測試的結果。了解更多有關Postman?測試的信息。 ## HISTORY 您使用PostMan發送的所有請求均存儲在您可以使用左邊欄訪問的歷史記錄(history)中。歷史可讓您快速嘗試各種請求，而不會浪費時間從頭開始構建請求。您可以通過單擊請求名稱來加載先前的請求。 如果您創建一個帳戶并登錄到PostMan，您的歷史記錄將與我們的服務器同步，實時備份，并可在您的設備上檢索。如果您退出您的PostMan帳戶，然后重新登錄，最后10個請求將保留在您的歷史記錄中。Postman Pro和Enterprise用戶將可以訪問最近的100個請求。相同的政策適用于收集運行。請記住，您可以隨時在收藏中保存盡可能多的請求。 ## Debugging and logs PostMan應用程序是PostMan廠家進行過廣泛的測試和測試版本。也就是說，可能是應用程序崩潰或出現意外行為的情況。如果你一直無法??排除??在自己的問題，你可以在文件中的問題GitHub的跟蹤，或訪問PostMan支持中心??，如果你想包含機密數據。將應用程序的控制臺日志包含在報告中將提供一些有用的數據進行故障排除。? PostMan控制臺類似于瀏覽器的開發者控制臺，除了適用于API開發。如果API或API測試不符合您的期望，那么這將是您在調試時進行深度潛水的地方。只要控制臺窗口打開，您的所有API活動將被記錄在這里，以查看發生什么了事情。? PostMan控制臺記錄以下信息： 1. 發送的實際請求，包括所有底層請求標頭和變量值等。 2. 由Postman處理服務器之前發送的確切響應 用于請求的代理配置和證書。 3. 來自測試或預請求腳本的錯誤日志 console.log()? 在腳本中使用`console.info()`或`console.warn()`在適當的位置將有助于提取正在起作用的確切的代碼行。 4. 如果你知道你`console.log()?`在JavaScript的方式，這是相似的。 ## 授權（Authorization） 當請求編輯器強大到足以構建任何類型的請求時，有時您可能需要一些幫助。PostMan有“helper”，可以簡化一些重復和復雜的任務。目前的助手讓您輕松處理身份驗證協議。您可以使用所有幫助器的環境變量。 您可以選擇將幫助數據保存到收集請求。這將導致每次重新生成簽名。這些助手甚至會在紐曼工作！ ## Generate code snippets(生成代碼) 一旦您確定并將您的請求保存在Postman中，您可能希望從您自己的應用程序發出相同的請求。Postan可以讓您以各種語言和框架生成代碼段，從而幫助您執行此操作。您需要點擊?藍色發送按鈕下的?代碼鏈接打開GENERATE CODE SNIPPETS模式。  ## 代理 代理服務器充當內部網絡和Internet之間的安全屏障，使Internet上的其他人無法訪問內部網絡上的信息。 Postman允許您配置自定義代理設置，指示Postman通過代理服務器轉發您的HTTP或HTTPS請求。換句話說，這將通過您選擇的代理服務器路由通過Postman應用程序發送的所有請求。