資料來源與金鑰
除了現成的整合,GetMyBot 還能透過連接器(來源區塊)和憑證(金鑰區塊)與任意 HTTP API 協作。連接器定義去哪裡,金鑰定義如何授權。查詢來源和寫入來源動作會用到它們。
連接器(來源)
來源 → 連接器。連接器包含名稱、類型、基礎 URL、繫結的憑證及標頭:
- REST — 任意 HTTP/JSON API。
- OzmaDB — OzmaDB/FunDB 實例;基礎 URL 填寫實例 REST API 的根路徑,匿名視圖請求已簡化。
- IMAP — 標記為「即將推出」。
測試按鈕會發送測試請求,顯示狀態與延遲(或錯誤)——方便確認 URL 與金鑰是否正確。
憑證(金鑰)
金鑰 → 憑證。Secret 以加密方式儲存。類型:
- API 金鑰 — 金鑰 + 標頭名稱(預設為
Authorization)。 - Bearer Token —
Authorization: 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(參見動作)。