資料來源與金鑰

除了現成的整合,GetMyBot 還能透過連接器來源區塊)和憑證金鑰區塊)與任意 HTTP API 協作。連接器定義去哪裡,金鑰定義如何授權查詢來源寫入來源動作會用到它們。

連接器(來源)

來源連接器。連接器包含名稱類型基礎 URL、繫結的憑證標頭

  • REST — 任意 HTTP/JSON API。
  • OzmaDB — OzmaDB/FunDB 實例;基礎 URL 填寫實例 REST API 的根路徑,匿名視圖請求已簡化。
  • IMAP — 標記為「即將推出」。

測試按鈕會發送測試請求,顯示狀態與延遲(或錯誤)——方便確認 URL 與金鑰是否正確。

憑證(金鑰)

金鑰憑證。Secret 以加密方式儲存。類型:

  • API 金鑰 — 金鑰 + 標頭名稱(預設為 Authorization)。
  • Bearer TokenAuthorization: Bearer 標頭中的 Token。
  • OAuth2(密碼) — Token URL、Client ID/Secret、帳號、密碼、scope。
  • OAuth2(刷新) — Token URL、Client ID/Secret、refresh token、scope。

對於 OAuth2,平台會自動取得並快取 Token,在到期或收到 401 回應時更新;refresh token 的輪換也會儲存。編輯時,Secret 欄位留空表示「不修改」。

從反應中讀寫資料

  • 查詢來源ds_query)— 透過連接器將資料讀入 ctx:指定路徑、指向陣列的 JSONPath 及結果的 ctx 鍵。之後可以列表循環遍歷陣列。
  • 寫入來源ds_write)— 以 JSON 格式的主體傳送資料(POST/PUT/DELETE)。

對於不需要儲存連接器的一次性請求,可使用 Web 請求動作;若要下載頁面文字,可使用載入 URL(參見動作)。

延伸閱讀