SocialHub.AI
开发者中心 · 开放扩展性

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调用笔记
subscribePOST /api/v2/webhooks{ url, eventTypes: [event] } → 响应 data.id 是订阅 ID。
unsubscribeDELETE /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 参考 中的每个可用操作。