開發者中心 · 開放擴充性
Zapier & Make 連接器
無需編寫程式碼即可將 Flash 連接到數千個應用程式。在 Zapier 或 Make 中,Flash 事件可以在任何位置啟動工作流程,而這些工作流程可以將資料推送回 Flash。 無需單獨安裝整合:連接器基於相同的 Webhook 和 v2 REST API 構建,相關文件請參見此處。
映射方式
三個部分,全部已經建好
每個無程式碼自動化流程都由觸發器、一個或多個操作以及身份驗證方法組成。 Flash 透過其現有平台介面提供所有這三項功能。
觸發器 = webhook 事件
連接器的觸發清單就是即時事件目錄——成員創建、等級升級、訂單下達等等。
操作 = v2 端點
操作會呼叫v2 REST 端點 — 建立會員、獎勵積分、發放優惠券、新增自訂object 記錄。
Auth = 作用域的 API 金鑰
連接器使用以 Authorization: Bearer 形式傳送的 fl_live_ 金鑰進行驗證,其作用域僅限於所需的操作和事件。
觸發器 — 底層原理
REST Hook 合約
Zapier 的 REST Hook 模型(以及 Make 的即時觸發器)直接對應到 Flash webhook 端點-無需額外的後端。 REST Hook 訂閱一個事件;當使用者關閉 Zap 時,它取消訂閱。所有三個生命週期步驟都使用 webhooks:manage 鍵。
| REST 連線步驟 | Flash調用 | 筆記 |
|---|---|---|
subscribe | POST /api/v2/webhooks | { url, eventTypes: [event] } → 回應 data.id 是訂閱 ID。 |
unsubscribe | DELETE /api/v2/webhooks/{id} | 訂閱時儲存的 id。 |
perform | (交付的 POST 正文) | 當事件觸發時,精簡有效負載 Flash 將執行。 |
# subscribe (what the connector does when a Zap turns on)
curl -X POST https://flash.socialhub.ai/api/v2/webhooks \
-H "Authorization: Bearer fl_live_..." \
-H "Content-Type: application/json" \
-d '{ "url": "https://hooks.zapier.com/...", "eventTypes": ["member.created"] }'
# 201 { "data": { "id": "whe_..." } } <-- stored as the subscription id
# unsubscribe (Zap turned off)
curl -X DELETE https://flash.socialhub.ai/api/v2/webhooks/whe_... \
-H "Authorization: Bearer fl_live_..."操作
將資料推送回 Flash
一個操作其實就是呼叫 v2 端點,並指定鍵的作用域。只需為連接器的鍵提供所需的內容即可——例如,使用 members:write 建立成員,或使用 objects:write 新增自訂 object 記錄—每次呼叫都會像其他任何 API 請求一樣進行驗證和稽核。
# example action: upsert a member when something happens in another app
curl -X POST https://flash.socialhub.ai/api/v2/members \
-H "Authorization: Bearer fl_live_..." \
-H "Content-Type: application/json" \
-d '{ "email": "ada@example.com", "fullName": "Ada Lovelace" }'在 Account → API Keys 中建立金鑰並確定其範圍。瀏覽 REST API 參考 中的每個可用操作。