節點 - 發送API請求
節點功能: 可以通過API URL取得外部系統的資料,也可以向指定API URL推送資料。
範例
- 當採購請求被審核後,將目前的資料推送到其他系統。
- 定期從訂單管理系統取得資料,並將取得的資料添加到工作表中。
它支援兩種資料處理方式,推送資料和取得資料。
- 發送自訂請求:即向第三方系統發送請求,取得或推送資料。支援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個欄位的更新涉及到值)在當前節點,則只跳過該欄位,其他欄位正常更新)。
中止行程
流程在此節點結束,後續節點不再執行。
文檔問題反饋
文檔中是否有錯字、內容過期、難以理解等問題? 點此給我們反饋吧