Zapier と Make コネクタ
コードを書かずに、Flash を数千ものアプリに接続できます。ZapierやMakeでは、Flash イベントでどこからでもワークフローを開始でき、そのワークフローから Flash にデータをプッシュバックできます。別途統合をインストールする必要はありません: コネクタは、ここで説明されている同じウェブフックとv2 REST API に基づいて構築されています。
3 つの部分、すべてすでに構築済み
すべてのコードなしの自動化は、トリガー、1 つ以上のアクション、および認証方法で構成されます。 Flash は、既存のプラットフォーム サーフェスから 3 つすべてを提供します。
トリガー = Webhook イベント
コネクタのトリガー リストは、メンバーの作成、階層のアップグレード、注文など、まさにライブ イベント カタログ です。
アクション = v2 エンドポイント
アクションは v2 REST エンドポイント を呼び出します。つまり、メンバーの作成、ポイントの付与、クーポンの発行、カスタム オブジェクト レコードの追加を行います。
Auth = スコープ付き API キー
コネクタは、必要なアクションとイベントのみを対象とした、Authorization: Bearer として送信された fl_live_ キーを使用して認証します。
REST フック コントラクト
Zapier の REST フック モデル (および Make のインスタント トリガー) は、追加のバックエンドなしで、Flash Webhook エンドポイントに直接マッピングされます。 REST フックは 1 つのイベントだけをサブスクライブします。ユーザーが Zap をオフにすると、購読が解除されます。 3 つのライフサイクル ステップはすべて 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" }'アカウント → API キー でキーを作成し、スコープを設定します。 REST API リファレンス で利用可能なすべてのアクションを参照してください。