HTTP 請求節點

定義

HTTP 請求節點是一個設計用於與外部伺服器或 API 通信的功能元件。它通過發送標準 HTTP 請求來實現「外部數據」和「效能數據」的交換與處理，適用於檢索外部數據、建立 Webhooks、生成圖像以及下載檔案等場景。

快速入門/使用方法：

節點配置詳情：在 GoInsight.AI 中，右鍵點擊並選擇「新增節點」，將 HTTP 請求節點新增至工作流程中。

1. 配置 HTTP 請求的 API 參數

API：HTTP 節點的 API 模組提供了一個方便的界面用於進行 API 呼叫。使用者只需輸入目標 API 地址，並可從以下六種標準 HTTP 方法中選擇適合的請求方式：

GET：用於向伺服器請求獲取特定資源。

POST：用於向伺服器提交數據，通常用於提交表單或上傳檔案。

HEAD：類似於 GET 請求，但伺服器僅返回資源的響應頭而不包含內容主體。

PATCH：用於部份更新資源的內容。

PUT：用於向伺服器上傳資源，通常用於更新或創建資源。

DELETE：用於請求伺服器刪除指定的資源。

常見 HTTP 響應狀態碼

在 HTTP 請求處理過程中，伺服器會返回不同的狀態碼，用以標明請求是否成功、失敗或需要進一步操作。下方列出常見的 HTTP 狀態碼分類及處理方式，可根據情況進行操作：

2. 目標 URL

輸入目標 URL 或輸入 / 以插入變數。僅支援 HTTP 和 HTTPS 協定。

例如，使用 GET 方法訪問 AirDroid 網站：

• 通過輸入 URL：輸入 https://www.airdroid.com



• 通過插入變數：例如，輸入 / 並選擇系統變數 Query。這樣將使用者的問題作為請求節點的目標 URL。

備註

執行此步驟是一個節點除錯功能，允許開發者獨立執行並驗證工作流程中的特定節點。點擊介面右上角的「執行此步驟」按鈕，便會僅執行當前選中的節點，以精準定位問題。

監看此節點也是一個節點偵錯功能。啟用此功能後，系統會自動將此節點中使用的所有變數標記為監看變數，並在偵錯面板中即時顯示其摘要資訊，幫助您快速掌握工作流程的狀態。

3. 配置 HTTP 請求頭和參數

1) Headers 是附加到請求或響應的後設資料。它們提供關於請求的額外資訊，類似於信封上的郵票和地址提供了信件的額外細節。

功能：包含關於請求的補充資訊，例如請求類型、發送者資訊、數據格式等。

• Content-Type：指定正在發送的數據格式（例如，application/json、application/x-www-form-urlencoded 等）。
• Authorization：包含 API 的認證資訊，例如權杖。
• 也可以使用其他自定義請求頭。

2) Params 是附加到 URL 的鍵值對，用於傳遞額外的查詢資訊。這就像在餐廳告訴服務生您想要額外的鹽或選擇不同的配菜。

功能：用於過濾或指定請求的某些條件。

如果有多組請求頭/參數，可以點擊右上角的「+」新增更多，點擊右下角的「刪除」移除。

4. 配置 HTTP 請求的主體內容

主體是請求中傳輸的實際數據內容。它就像信件的正文，包含您想要傳達的主要資訊。

功能：包含需要發送到伺服器的數據，例如表單資訊、檔案內容等。

主體格式：HTTP 節點為主體格式提供靈活的配置，支援五種常見數據格式以適應不同的介面要求：

1. None：表示發送請求時不附加任何數據。這種情況通常發生在以下情況：

• GET 請求：GET 請求通常用於從伺服器檢索數據而不是發送數據，因此通常不需要請求主體。在這種情況下，body 為 None 是正常的。
• DELETE 請求：類似於 GET 請求，DELETE 請求通常用於刪除資源，通常不需要請求主體。
• 不需要數據：某些 API，例如簡單的觸發操作或狀態查詢，其設計不需要請求主體。
• 預設設定：如果請求類型支援請求主體（如 POST 或 PUT），但在特定情況下不需要任何數據，則主體也可能設定為 None。

2. form-data：一種用於發送表單數據的格式，通常用於檔案上傳。

• 用途：主要用於需要檔案上傳的場景，因為它可以處理二進位和文字數據。
• 實作：使用
  multipart/form-data
  作為
  Content-Type
  ，每個欄位都有自己的內容描述和邊界。
• 不需要數據：某些 API，例如簡單的觸發操作或狀態查詢，其設計不需要請求主體。
• 範例：在 HTML 表單中選擇檔案上傳時使用。

3. x-www-form-urlencoded：一種將表單數據編碼為鍵值對的格式，以 URL 編碼格式發送數據。

• 用途：適用於發送簡單的表單數據，通常用於 POST 請求。
• 實作：數據以
  key1=value1&key2=value2
  格式在請求主體中發送，特殊字元會進行編碼。
• 範例：提交 HTML 表單時預設使用此格式。

4. raw text：指發送沒有特定編碼格式的純文字數據。

• 用途：適用於需要發送純文字數據的場景。
• 實作：
  Content-Type
  可以指定為
  text/plain
  以直接發送未編碼的文字。
• 範例：發送簡單的文字訊息或日誌數據。

5. JSON：用於發送結構化的 JSON 數據。

• 用途：廣泛用於
  RESTful APIs
  ，因為 JSON 易於讀取和解析。
• 實作：使用
  application/json
  作為
  Content-Type
  ，數據以 JSON 格式發送。
• 範例：發送複雜的物件或陣列數據，例如 {"name": "John", "age": 30}。

5. HTTP 請求逾時設定

逾時設定是一個閾值參數，用於控制請求等待響應的最長時間。您可以根據需要設定逾時持續時間（以秒為單位），預設值為 30 秒。

功能：它有助於防止工作流程卡住或延遲；它強制終止無限期等待而沒有響應的請求。

6. 錯誤處理

為節點配置錯誤處理策略。如果在節點執行期間發生嚴重錯誤，導致節點無法產生結果，將應用此策略以防止整個工作流程中斷。

有關錯誤處理機制的更多詳細資訊，請參閱：節點錯誤處理策略

典型使用案例

HTTP 請求節點充當橋樑，促進您的系統與其他外部服務或應用程式之間的通信。想像一下您的工作流程需要從外部來源獲取資訊或發送資訊；這時 HTTP 請求節點就派上用場了。

• GET 請求：GET 請求通常用於從伺服器檢索數據而不是發送數據，因此它們通常不需要請求主體。在這種情況下，
  body
  為
  None
  是正常的。
• 呼叫第三方 API 收集數據：例如，通過連結檢索 YouTube 影片的標題、訂閱者數量和觀看次數。
• 與企業內部系統整合：例如，使用企業系統的 API 介面定期發送收集到的資訊。

實際案例場景

客戶支援系統中自動化工單分類工作流程的設計步驟：

• 1. 開始節點：
  • 收集客戶提交的資訊，包括帳戶詳細資訊、問題描述、優先級和問題類型。
• 2. HTTP 請求節點（創建工單）：
  • 請求方法：POST
  • URL：用於創建工單的 API 端點。
  • 主體：包含客戶資訊、問題詳細資訊、優先級和問題類型。
  • 輸出：檢索已創建的工單 ID。
• 3. 自然語意分類器（問題分類）：
  • 分類用戶查詢，例如技術問題和帳單問題。
• 4. HTTP 請求節點（分類至技術支援部門）：
  • 請求方法：POST
  • URL：技術支援團隊內部系統的 API 端點。
  • 主體：包含工單 ID 和問題詳細資訊。
• 5. HTTP 請求節點（分類至帳單支援部門）：
  • 請求方法：POST
  • URL：帳單支援團隊內部系統的 API 端點。
  • 主體：包含工單 ID 和問題詳細資訊。
• 6. 結束節點：結束工作流程。

通過此工作流程，客戶填寫所需資訊後，工單可以自動創建並自動分類。

備註

• 法律風險：遵守機器人排除協定，避免非法網路爬蟲。
• 速率限制：第三方 API 通常有 QPS（每秒查詢次數）限制，以確保所有用戶的公平訪問。
• 成本控制：某些 API 會根據呼叫次數收費；請留意定價。

常見問題解答

Q1: 如何處理超時問題？

調整超時設定參數，預設值為30秒，可根據需要進行修改。

Q2: 如何找到合適的API？

許多網站提供各種API接口，例如rapidapi.com。