設置調用API接口

調用API接口板塊提供自動 HTTP 回調函數,您可以使用這些函數通過各種方法執行 API 請求,包括 GET、POST、PUT、DELETE 等。

網址(URL)及方法

選擇請求方法並輸入外部 API 的 URL 端點。您可以通過將變量插入路徑來使 URL 動態化。對於您在流程中設置的用戶輸入變量,例如,它名為“order_num”,您可以使用 {{order_num}} 來調用它。對於自定義字段,對於名為“membership”的字段,您可以將其命名為 {{customFields.membership}}。

自定義標題

HTTP API 請求中的標題用於指定 API 的用途或其內容類型。是否使用標題是可選項目, 它位於“附加設置”下,默認情況下處於關閉狀態。標題設置為一對:鍵+值。例如 鍵=內容類型 值=應用程序。

客製化正文

調用 API 請求的正文添加到此處。 這也是可選的,預設為關閉。 正文必須始終採用 JSON 格式。 格式提示: • 字串和變數必須用引號括起來> {{name}} • 2個鍵值對之間需要逗號> "Email": "{{email}}", "Name": "{{name }}" • 變數是自訂欄位而非預設欄位(即姓名、電子郵件、電話),例如欄位名稱是membership,則格式應為>「{{customFields.membership}}」。

設置測試變量

通過單擊“添加變量”手動設置測試變量。

測試請求

您可以通過單擊“測試請求”按鈕來測試 API 請求。

將回應保存為變量

還可以將請求的回應保存到變量或自定義屬性中。如果您的 API 回應是帶有鍵值對的 JSON,您可以通過傳遞鍵名稱來存儲每個值。

存儲對象內部的回應值

如果要存儲對象內的回應值,則需要使用 objectkey.keyname 格式。例子:如果要存儲 userId,則必須在上面的“整個回應正文”中使用 Result.userId

{ 
    "Result": { 
        "userId": "xxxxx", 
        "PhoneNumber": "xxxxxx", 
        "PurchaseHistory": null, 
    }
}

存儲對像數組內的回應值

如果要存儲對像數組內的回應值,則需要使用 $.[0].objectkey.keyname[0].value 格式。例子:如果您想存儲shipping_status,則必須在上面的“整個回應正文”中使用 $.[0].order_tracking.shipment_track[0].shipping_status

[
    {
        "order_tracking": {
            "track_status":0,
            "shipment_track" : [
                {
                    "id":123342515,
                    "shipping_status":"On the way"
                }
            ]
        }
    }
]

回應路由

您可以根據回應狀態碼,然後使用回應路由來拆分流程。默認情況下,每個 Webhook 塊都有“成功”和“失敗”節點。您可以根據需要選擇添加自定義狀態代碼。

Last updated