使用 Postman 發送請求

1. 前言

你可以通過 Postman 發起 API 請求。一個 API 請求允許你從數據源請求數據或者添加數據。 API 運行在 Web 服務器上，并把端口暴露出來供客戶調用。

利用 Postman, 不需要使用終端也不需要寫代碼，你就可以發起 API 請求并且檢查請求的響應。當你創建完 API 請求并發送之后， API 響應就會顯示在 Postman 用戶界面中。

下圖是 Postman 進行 API 請求的簡單示例：

2. 創建新的請求

在 Postman 發送請求要填寫一些信息，有些信息是必填的包括請求 URL，請求方法(比如: POST / GET / PATCH / DELETE)，有些信息是選填的，比如攜帶的參數、認證信息和主體信息。

在 Postman 首頁中點擊 New -> Request (新建 -> 請求)，也可以通過點擊首頁上的“+”添加一個新的 tab，來創建請求。

點完之后，會彈出如下彈窗，需要輸入請求名和描述，以及選擇這個請求要保存在哪個集合里（如果還沒有集合，可以在彈窗中創建）：

3. 輸入請求的URL

如下圖所示，在輸入框中輸入 URL。

• 如果你正在創建一個 API, URL 通常是由基礎路由加端點路徑構成的；例如：在請求“postman-echo.com/get”中，“postman-echo.com”是基礎路由，“/get”是端點路徑。

• 如果你使用的是第三方 API，那第三方會提供給你相應的 URL。

4. 選擇請求方法

默認情況下，Postman 會為新請求選擇 GET 方法。API 請求用的都是 HTTP 方法。 最常見的方法包括 GET、POST、PATCH、PUT和 DELETE。

• GET 方法從 API 獲取數據；

• POST 方法向 API 發送添加新數據；

• PATCH 和 PUT 方法用來更新數據；

• DELETE 方法用來刪除已存在的數據；

除了這些 Postman 默認支持的請求方法，你還可以自定義請求方法。單擊方法下拉列表 -> 編輯方法名稱 -> 保存新方法。要刪除一個方法，請將鼠標懸停在列表中的方法上，然后選擇“垃圾桶”圖標。

• 如果請求不需要參數或身份驗證，可以繼續單擊“發送”請求以獲取響應；
• 否則，指定 API 的參數和主體數據；
• 如果需要，設置所需的身份驗證和請求頭。

5. 設置請求參數

在發送請求的時候，還可以攜帶參數。

• 查詢參數會被加到 URL 的末尾， 跟在 ？ 后面并以鍵值對的形式列出， 以 & 分割，類似以下語法: ?id=1&type=new
• 路徑參數組成請求 URL 的一部分，會用占位符加參數的形式來引用，如下例所示: /customer/:id
  要發送查詢參數，請直接將其添加到 URL 或打開 Params 并輸入名稱和值。

參數不會自動變成URL編碼，需要手動操作，右鍵點擊被選中的需要被編碼的文字，選擇 **EncodeURIComponent ** 手動編碼。

要發送路徑參數，請在 URL 字段中輸入參數名稱，在冒號之后，例如 :id。當你輸入一個路徑參數，Postman 將填充它在 Params 頁。

還可以給參數添加描述，當把請求分享給其他人時，他們也可以看到請求的描述幫助理解。

如果請求不需要輸入主體數據、身份驗證或者請求頭，這時就可以點擊“Send”來發送請求。

Tips：如果你不想用鍵值對編輯頁面，你可以切換到“Bulk Edit”，就是純文本編輯。

6. 設置主體數據：

當想要添加或者更新結構化數據的時候，請求就要攜帶主體數據。一般 PUT, POST, PATCH 這幾類請求是需要攜帶主體數據的。

可以在 Postman 中的 Body 選項卡里輸入主體數據。

如果你要發送主體數據，一定要選擇正確的請求頭，以確保API可以正確處理發送的這些數據：

• 對于表單數據和 urlencoded 內容，Postman 會自動附加正確的 Content-Type 頭；
• 如果你的主體數據使用的是原始模式，Postman 會根據你選擇的類型設置請求頭（e.g. text, json）；
• Postman 不會為二進制主體數據設置請求頭。

7. 配置身份驗證信息

有一些 API 出于安全考慮，不會開放給任何人，所以需要身份驗證信息以授權該用戶可以訪問 API。

Postman 會自動把認證信息放到請求的相關部分，比如放到請求頭。

8. 配置請求頭

有一些API要求你在發送請求的時候設置請求頭來提供需要的元數據?？梢栽?Headers 選項卡里進行設置，輸入需要的鍵值對。

最后，這些配置完成后，點擊發送，會在下面窗口中看到來自服務器的 JSON 數據響應：

9. 小結

本章向大家講了如何在 Postman 中發送一個請求并介紹了請求方法，請求參數，主體數據，驗證信息以及請求頭的設置方法。