網路請求與 Webhook
讓網站事件啟動機器人,或讓反應向其他服務查詢資料;設定傳入與傳出的 HTTP 請求。
本頁內容
網站可以通知機器人有新申請;機器人也可以向網站查詢訂單狀態。這是兩個不同方向:
| 方向 | 由誰開始 | 例子 |
|---|---|---|
| 傳入 Webhook | 其他服務通知 GetMyBot 並啟動反應 | 網站收到申請,機器人通知經理 |
| 傳出網路請求 | 反應向其他服務查詢並取得回應 | 機器人查詢價格或訂單狀態 |
Webhook 是服務之間自動傳送的通知。兩種方式都使用 HTTP。若需現成連接,請參閱整合。
傳入 Webhook(觸發條件)
**傳入網路請求(Webhook)**觸發條件會在外部 HTTP 請求到達時啟動反應:
- 網址:啟用觸發條件並儲存反應後,GetMyBot 才會自動建立並顯示 Webhook URL。可複製,但不能修改。
- 秘密權杖:防止其他人用該網址擅自啟動反應。
- 方法:
POST、GET、PUT或ANY。
收到的欄位會進入反應暫存資料 ctx。例如服務傳來 order_id,動作便可使用 {{ctx.order_id}}。設定後請傳送測試請求,確認反應取得正確欄位。
傳出網路請求(動作)
網路請求動作從反應中發送 HTTP 請求,可設定:
- 方法:
GET、HEAD、OPTIONS、POST、PUT、PATCH或DELETE;以及標頭和 JSON/文字內容。 - 成功狀態碼、逾時與錯誤重試次數。
- 將回應儲存到使用者參數或暫存
ctx;用 JSONPath 選取所需欄位。 - 非同步執行:反應不必等候外部回應;之後可按成功/失敗啟動另一條反應。
相關動作還有載入 URL(把頁面文字放入 ctx),以及已儲存連接器的查詢資料來源/寫入資料來源;詳見資料來源與金鑰。
Webhook 整合
經常向同一服務傳送資料時,可設定 Webhook 整合,提供服務 URL 和 HMAC 簽章,讓接收端驗證來源。詳見整合。
安全性
傳入請求須設定秘密權杖。平台不允許傳出請求存取內部網路的私人網址,這項防護稱為 SSRF;回應大小亦受限制。