SocialHub.AI
Geliştirici Merkezi · Açık Genişletilebilirlik

Zapier & Make Bağlantı Elemanları

Kod yazmadan binlerce uygulamaya Flash bağlayın. Zapier veya Make'te, bir Flash olayı herhangi bir yerde bir iş akışını başlatabilir ve bu iş akışları verileri Flash'e geri gönderebilir. Kurulacak ayrı bir entegrasyon yok: bağlayıcılar, burada belgelenen aynı web kancaları ve v2 REST API üzerine kuruludur.

Nasıl eşleniyor

Üç parça, hepsi zaten inşa edilmiş

Her kodsuz otomasyon bir tetikleyici, bir veya daha fazla eylem ve bir kimlik doğrulama yönteminden oluşur. Flash, mevcut platform yüzeyinden bunların üçünü de sağlar.

Tetikleyiciler = webhook etkinlikleri

Bir bağlayıcının tetikleyici listesi, tam olarak canlı etkinlik kataloğudur — üye oluşturuldu, kademe yükseltildi, sipariş verildi vb.

Eylemler = v2 uç noktaları

Bir işlem, bir v2 REST uç noktası çağırır — üye oluşturma, puan verme, kupon verme, özel bir object kaydı ekleme.

Kimlik doğrulama = kapsamlı bir API anahtarı

Bağlayıcı, yalnızca ihtiyaç duyduğu eylemler ve olaylarla sınırlı olarak, Authorization: Bearer olarak gönderilen bir fl_live_ anahtarıyla kimlik doğrulaması yapar.

Tetikleyiciler — arka planda

REST Kanca sözleşmesi

Zapier'in REST Kanca modeli (ve Make'in anlık tetikleyicileri) doğrudan Flash web kancası uç noktalarına eşlenir - ekstra bir arka uç yok. Bir REST Kanca tam olarak bir olaya abone olur; kullanıcı bir Zap'ı kapattığında abonelikten çıkar. Üç yaşam döngüsü adımının tamamı webhooks:manage anahtarını kullanır.

REST Kanca adımıFlash çağrısıNotlar
subscribePOST /api/v2/webhooks{ url, eventTypes: [event] } → data.id yanıtı abonelik kimliğidir.
unsubscribeDELETE /api/v2/webhooks/{id}Abone olma sırasında saklanan id.
perform(teslim edilen POST gövdesi)Etkinlik tetiklendiğinde ince veri Flash yayınlanır.
# 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_..."
Eylemler

Verileri Flash içine geri aktarın

Bir eylem yalnızca anahtarın kapsamlarına sahip bir v2 uç noktasına yapılan çağrıdır. Bağlayıcının anahtarına yalnızca ihtiyaç duyduğu şeyi verin (örneğin, üye oluşturmak için members:write veya özel nesne kayıtları eklemek için objects:write) ve her çağrının kimliği, diğer API istekleri gibi doğrulanır ve denetlenir.

# 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" }'

Hesap → API Anahtarlar'da anahtarları oluşturun ve kapsamını belirleyin. REST API referansında mevcut tüm işlemlere göz atın.