Zapier و Make Connectors
ربط Flash بآلاف التطبيقات دون كتابة أي كود. في Zapier أو Make، يمكن لحدث Flash بدء سير عمل في أي مكان، ويمكن لهذه السير إرسال البيانات مرة أخرى إلى Flash. لا يوجد تكامل منفصل للتثبيت: تم بناء الموصلات على نفس خطافات الويب والإصدار 2 REST API الموثق هنا.
ثلاثة أجزاء، جميعها جاهزة
تتكون كل عملية تشغيل آلي بدون كتابة أكواد من مُشغّل، وإجراء واحد أو أكثر، وطريقة مصادقة. يوفر Flash العناصر الثلاثة جميعها من خلال منصته الحالية.
المحفزات = أحداث Webhook
قائمة مُشغّلات الموصل هي نفسها تمامًا كتالوج أحداث المباشر — إنشاء عضو، ترقية المستوى، تقديم طلب، وما إلى ذلك.
الإجراءات = نقاط نهاية الإصدار الثاني
يُفعّل إجراءٌ ما نقطة نهاية v2 REST — إنشاء عضو، منح نقاط، إصدار قسيمة، إضافة سجل مخصص object.
التفويض = مفتاح API ذو نطاق محدد
يُصادق الموصل باستخدام مفتاح fl_live_ يُرسل كمفتاح Authorization: Bearer، ويقتصر نطاقه على الإجراءات والأحداث المطلوبة فقط.
عقد الربط REST
يرتبط نموذج الخطاف REST في Zapier (ومحفزات Make الفورية) مباشرةً بنقاط نهاية webhook Flash - دون الحاجة إلى أي بنية خلفية إضافية. يشترك الخطاف REST في حدث واحد فقط؛ وعندما يُعطّل المستخدم Zap، يتم إلغاء اشتراكه. تستخدم جميع خطوات دورة الحياة الثلاث مفتاح webhooks:manage.
| REST خطوة الربط | Flash مكالمة | ملاحظات |
|---|---|---|
subscribe | POST /api/v2/webhooks | { url, eventTypes: [event] } → الاستجابة data.id هي معرّف الاشتراك. |
unsubscribe | DELETE /api/v2/webhooks/{id} | يُخزَّن id عند الاشتراك. |
perform | (نص رسالة POST المُرسلة) | يُقدّم نظام thin payload 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 آخر.
يحتوي كل استدعاء على معلومات المصادقة والتدقيق مثل أي طلب 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 المرجعي.