使用 Postman 發(fā)送請求

1. 前言

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

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

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

2. 創(chuàng)建新的請求

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

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

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

3. 輸入請求的URL

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

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

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

4. 選擇請求方法

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

• GET 方法從 API 獲取數(shù)據(jù)；

• POST 方法向 API 發(fā)送添加新數(shù)據(jù)；

• PATCH 和 PUT 方法用來更新數(shù)據(jù)；

• DELETE 方法用來刪除已存在的數(shù)據(jù)；

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

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

5. 設置請求參數(shù)

在發(fā)送請求的時候，還可以攜帶參數(shù)。

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

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

要發(fā)送路徑參數(shù)，請在 URL 字段中輸入?yún)?shù)名稱，在冒號之后，例如 :id。當你輸入一個路徑參數(shù)，Postman 將填充它在 Params 頁。

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

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

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

6. 設置主體數(shù)據(jù)：

當想要添加或者更新結(jié)構(gòu)化數(shù)據(jù)的時候，請求就要攜帶主體數(shù)據(jù)。一般 PUT, POST, PATCH 這幾類請求是需要攜帶主體數(shù)據(jù)的。

可以在 Postman 中的 Body 選項卡里輸入主體數(shù)據(jù)。

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

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

7. 配置身份驗證信息

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

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

8. 配置請求頭

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

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

9. 小結(jié)

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