开发者中心 · 开放扩展性
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 添加自定义对象记录 - 每个调用都会像任何其他 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 参考 中的每个可用操作。