跳至主要内容

節點 - 發送API請求


節點功能: 可以通過API URL取得外部系統的資料,也可以向指定API URL推送資料。

範例

  1. 當採購請求被審核後,將目前的資料推送到其他系統。
  2. 定期從訂單管理系統取得資料,並將取得的資料添加到工作表中。

它支援兩種資料處理方式,推送資料和取得資料。

  • 發送自訂請求:即向第三方系統發送請求,取得或推送資料。支援Get、Post、Put、Delete、Head、Patch 6種方法。
  • 傳送指定資料物件:即將工作表中的資料推送至第三方系統。

一、發送自訂請求

1. GET 方式

範例:當公開收集課程評論時,您可以取得使用者的IP位址,並從相關API服務中取得該IP的歸屬並將其寫入對應的欄位中。

1.1 API URL

此處貼上API URL。支持參數值的靜態或動態拼接

如果要求時需要Web代理或SSL憑證驗證,請勾選。

管理員進入【組織管理】> 【整合】> 【其他】設定Web代理。

1.2 Headers

有些系統需要授權資訊或其他參數,只需在上面的【API URL】中設定即可。

有些系統需要將參數設定在Headers中。

如下介面範例所示:

設定方式:

header中的token稱為Authorization(即授權憑證),後面直接寫入您的token值即可。

1.3 可信任 IP位址

有時候,有些第三方平台需要可信任IP來呼叫API。每個請求都有一個隨機IP。

1.4 請求失敗設定

您可以設定請求失敗時的狀態碼和錯誤訊息。

  • 將成功請求的狀態碼寫在一起,用英文逗號分隔。
  • 分別設定錯誤代碼和錯誤訊息。

錯誤會顯示在工作流的運行歷史資料中。

1.5 測試API

設定完上述內容後,測試API。

如果請求URL中的參數使用節點的動態值,則在第一次測試時,會要求您填寫參數的測試資料,填寫完畢後,您可以將測試值替換為動態參數,然後發送要求。所有欄位都不是必需的,您可以將它們保留為空,並使用 null 值進行請求。再次點擊測試API時,參數將是最後填寫的值。

  • 測試支援請求時間、返回狀態碼、請求耗時(單位秒);
  • 原返回參數添加[Response Body]命名,並添加[Response Header] ,內容為 API 傳回的 header 列表;
  • 如果請求方法為HEAD且沒有傳回body值,則不顯示回應body;
  • 被後續節點使用時,動態值與Body和Header一起顯示,沒有Body則不顯示;

1.6 當請求逾時或失敗

如果請求時間超過 10 秒,則請求逾時。當請求逾時或失敗時,後續節點可以透過兩種方式處理:

  • 繼續該過程

    繼續執行下列節點。如果當前節點中存在後續節點使用資料或物件,則跳過對應項(例如【更新資料】節點中需要更新5個欄位,其中1個欄位的更新涉及到值)在當前節點,則只跳過該欄位,其他欄位正常更新)。

  • 中止行程

    流程在此節點結束,後續節點不再執行。


文檔問題反饋

文檔中是否有錯字、內容過期、難以理解等問題? 點此給我們反饋吧