如何配置HTTP請求組件？ - Chat App Message Service

本文介紹HTTP請求組件的配置詳情。此組件可以向設定的URL發送HTTP請求。

組件資訊

元件圖表標	組件名稱
	HTTP請求。

前提條件

可以通過已存在的流程或者建立新的流程進入流程的畫布編排頁面。

進入已存在的流程畫布編排頁面
在流程编辑器 > 流程管理頁簽，單擊需編輯的流程名称，進入流程的編排頁面。
建立新的流程進入畫布編排頁面。具體操作請參見建立流程。

操作步驟

單擊畫布上的HTTP請求元件圖表標，查看右側組件配置地區。
右側配置面板包含可用變數地區（如 incomingMessage、wabaId、wabaPhoneNumber 等）和基礎設定地區，可配置請求方式（預設 GET）、逾時（單位秒）、地址（必填）及失敗分支開關；還可通過添加要求標頭和添加路徑參數擴充配置。完成配置後，單擊右上方儲存。
根據需求配置組件資料，詳細配置說明請參見配置項說明。
配置完成後，單擊保存，在彈出的對話方塊中單擊保存，完成儲存。

配置項說明

配置項	說明	樣本
请求方式	支援以下方式： POST。 GET。	基礎設定中還包含以下配置項：逾時（單位為秒）、地址（必填）、失敗分支（開關控制，預設關閉）和內容類型（必填）。
超时	設定請求響應逾時時間。
地址	設定接收請求的URL地址。
内容类型	當請求方式選擇POST時，需要設定内容类型。支援以下類型： application/json。 application/x-www-form-urlencoded。
失败分支	開啟失敗分支以處理請求失敗的流程。
请求头配置	填寫以下資訊： key。 value。	在 Key 中填寫 `accesstoken`，在 Value 中填寫對應的令牌值。如需引用已有變數，可單擊插入變數；如需添加更多要求標頭，可單擊添加要求標頭。
请求体配置	當請求方式為 POST 時，可配置請求體：索引值： key。 value。原始值：原始值需手動輸入。配置詳情您可參見請求體配置樣本及說明。	配置請求體參數時，選擇索引值模式並設定 Key 和 Value，或選擇原始值模式手動輸入內容。可單擊插入變數添加變數值，也可單擊添加Body添加更多參數。
请求路径配置	當請求方式為GET時，可配置請求路徑： key。 value。	配置GET請求URL參數時，設定 Key 為 `phone`，Value 為 `{{$.PhoneNumber}}`。可單擊 + 插入變數添加變數值，也可單擊 + 添加參數添加更多參數。
响应变量配置	確保變數名與響應中JSON對象上的鍵匹配	在響應變數提取地區輸入變數名，單擊+ 添加變數可添加更多變數，單擊刪除表徵圖可移除已有變數。

請求體配置樣本及說明

請求體的配置包含兩種方式：键值，原始值。

键值：當您的請求體結構較為簡單時推薦使用此模式，可參考如下樣本：
配置第一組索引值的Key為MyName，Value為haiwei.dhw；第二組索引值的Key為customerName，Value為變數{{customerName}}。
此時，其對應內容類型為application/json時的資料格式為：{"myName": "haiwei.dhw", "customerName": "{{customerName}}"}；其對應內容類型為application/x-www-form-urlencoded時的資料格式為："myName=haiwei.dhw&customerName={{customerName}}"。
原始值：當您的請求結構較為複雜時推薦使用此模式，您可以自由編輯整個請求體，請求體原始值需與您選擇的內容類型相對應，內容類型分為application/json和application/x-www-form-urlencoded。
application/json
內容類型為application/json時，請求體原始值可參考如下樣本：
```
{
  "customerNames": [
    {
      "name": "{{customerName}}",
      "type": "vip",
      "intentional": true,
      "intentionLevel": 5
    }
  ],
  "myName": "haiwei.dhw",
  "someConplicatedStructure": {
    "a": {
      "b": "c"
    }
  }
}
```
application/x-www-form-urlencoded
內容類型為application/x-www-form-urlencoded時，請求體原始值可參考如下樣本：
```
customerNames[0][name]={{customerName}}&customerNames[0]
[type]=vip&customerNames[0]
[intentional]=true&customerNames[0]
[intentionLevel]=5&myName=haiwei.dhw&someConplicatedStructure[a][b]=c
```

組件資訊

前提條件

操作步驟

配置項說明

請求體配置樣本及說明

application/json

application/x-www-form-urlencoded