REST API مرجع
71 نقاط النهاية عبر موارد 19. يُمكّنك SocialHub v2 REST API من إدارة المتاجر، وأعضاء برنامج الولاء، والنقاط، والقسائم، وعمليات الاستحواذ، وبرنامج السفراء، والتتبع. تتطلب جميع نقاط النهاية الإصدار Authorization: Bearer fl_live_… ما لم يُذكر خلاف ذلك.
https://flash.socialhub.ai/api/v2هذا المرجع يُطابق API. المباشر. إنه لقطة ثابتة لكتالوج نقاط النهاية، مُصنفة حسب المورد. للاطلاع على العقد المُحدّث باستمرار والقابل للقراءة آليًا (المعلمات، وبيانات الطلب، ومخططات الاستجابة)، راجع OpenAPI JSON →
المصادقة باستخدام مفتاح حامل
يتم التحقق من كل طلب باستخدام مفتاح SocialHub API (fl_live_…) المُرسل كرمز حامل. تكون المفاتيح مُخصصة لفريقك ولكل أداة على حدة - أنشئها وقم بإدارتها في حساب SocialHub الخاص بك.
curl https://flash.socialhub.ai/api/v2/members \
-H "Authorization: Bearer fl_live_your_key_here"هل تفضل إبقاء المفتاح النصي العادي خارج سجل أوامر shell؟ قم بتصديره كـ FLASH_API_KEY وقم بالإشارة إلى متغير البيئة.
قم بتعيين مفتاح كـ مفتاح اختبار لإنشاء بيئة تجريبية على نفس عنوان URL الأساسي - لا حاجة لبيئة أو بيانات اعتماد منفصلة. يتم وسم البيانات المكتوبة به (الأعضاء، الطلبات، القسائم) وإخفاؤها عن قوائمك ولوحات معلوماتك الفعلية؛ لا يتم التواصل مع عضو الاختبار فعليًا (يتم تعطيل رسائل البريد الإلكتروني التسويقية والرسائل النصية القصيرة والإشعارات الفورية) ولا يتم استرداد قسيمة الاختبار أبدًا بقيمة حقيقية؛ ويؤدي استخدام POST /api/v2/test-data/purge مرة واحدة إلى مسح كل شيء. جرب بحرية، ثم أعد التعيين.
نقاط النهاية
71 نقاط النهاية عبر 19 مجموعات الموارد. الطريقة والمسار وملخص من سطر واحد لكل منها - تفاصيل المعلمات والمخطط الكاملة موجودة في OpenAPI JSON.
CWM التوقعات
4 نقطة النهاية sCWMتوزيع الحدث التالي النهائي الوحيد، TimesFM 2.5 توقعات الطلب ونوافذ دمج المستأجرين والقطاع الخاص. تتطلب السلوكيات التالية predictions:readتتطلب الاتجاهات/النوافذ أيضًا metrics:readاحتمالات الحدث التالي غير مُعايرة وتعتمد على الأهداف المدعومة؛ وتبقى نوافذ الاندماج null إلى حين التدريب والتحقق من صحة البيانات.
/api/v2/cwm/capabilities/api/v2/cwm/members/{id}/next-behaviors/api/v2/cwm/trends/api/v2/cwm/members/{id}/purchase-windowsالمتاجر
4 نقطة النهاية sإدارة المتجر
/api/v2/stores/api/v2/stores/{id}/api/v2/stores/api/v2/stores/{id}الأعضاء
12 نقطة النهاية sإدارة أعضاء برنامج الولاء
/api/v2/members/api/v2/members/api/v2/members/batch/api/v2/members/{id}/api/v2/members/{id}/api/v2/members/{id}/points/api/v2/members/{id}/points/api/v2/members/{id}/tier/api/v2/members/{id}/coupons/api/v2/members/{id}/receipts/api/v2/members/{id}/profile/api/v2/members/{id}/redeem-couponالطلبات
4 نقطة النهاية sاستلام الطلبات ← منح النقاط تلقائيًا، واسترداد الأموال، والتسوية
/api/v2/orders/api/v2/orders/api/v2/orders/batch/api/v2/orders/{externalOrderId}/refundالكتالوج
5 نقطة النهاية sكتالوج المنتجات (PIM) - المنتجات، والأنواع، والفئات، والعلامات التجارية؛ استيراد من نظام تخطيط موارد المؤسسات (ERP)/Shopify
/api/v2/products/api/v2/products/{id}/api/v2/categories/api/v2/brands/api/v2/catalog/importحقول مخصصة
2 نقطة النهاية sقراءة الحقول المخصصة المُعرّفة من قِبل المستأجر لأي كيان (عضو / متجر / منتج / مجموعة قسائم / طلب). للقراءة فقط؛ غير حساسة بطبيعتها. النطاق: custom_fields:read.
/api/v2/custom-fields/api/v2/custom-fields/valuesالتقاط البيانات
1 نقطة النهايةالتقاط السجلات
/api/v2/capturesقسائم شرائية
4 نقطة النهاية sمجموعات القسائم، والرموز، والاسترداد
/api/v2/coupons/api/v2/coupons/pools/api/v2/coupons/issue/api/v2/coupons/{id}/redeemالسفير
3 نقطة النهاية sبرنامج السفراء - المرشحون، تقرير عائد الاستثمار، ورموز التسويق بالعمولة
/api/v2/ambassador/candidates/api/v2/ambassador/metrics/api/v2/ambassador/members/{id}/issue-codeالتتبع
2 نقطة النهاية sتحليلات زيارات الصفحات وسلوك المستخدمين واستيعاب الأحداث
/api/v2/tracking/stats/api/v2/tracking/eventsAPI المفاتيح
3 نقطة النهاية sAPI إدارة المفاتيح
/api/v2/api-keys/api/v2/api-keys/api/v2/api-keys/{id}التفويض
7 نقطة النهاية sالمصادقة وملف تعريف المستخدم
/api/v2/auth/register/api/v2/auth/login/api/v2/auth/profile/api/v2/auth/profile/api/v2/auth/change-password/api/v2/auth/forgot-password/api/v2/auth/reset-passwordالقطاعات
5 نقطة النهاية sشرائح الجمهور - شروط مُهيكلة تُستخدم لاستهداف الحملات
/api/v2/segments/api/v2/segments/api/v2/segments/{id}/api/v2/segments/{id}/api/v2/segments/{id}الحملات التسويقية
3 نقطة النهاية sالحملات - إنشاء قوائم ومسودات (لا تُرسل أبدًا؛ يراجعها شخص بشري ثم يرسلها).
/api/v2/campaigns/api/v2/campaigns/api/v2/campaigns/{id}الأتمتة
2 نقطة النهاية sالأتمتة — سرد التدفقات المُفعّلة بالأحداث وإيقافها مؤقتًا/استئنافها
/api/v2/automations/api/v2/automations/{id}معاملة تجارية
1 نقطة النهايةإرسال المعاملات — يقوم نظامك بإرسال حملة إلى مستلم واحد، وقد فعّلها المستخدم صراحةً للاستخدام في المعاملات (تأكيدات الطلبات، الإيصالات). لا يقوم API بإنشاء المحتوى أبدًا؛ ويتم دائمًا احترام قيود إمكانية التسليم. مرر مفتاح idempotency_key لجعل إعادة المحاولات آمنة
/api/v2/transactional/sendالواردات
4 نقطة النهاية sاستيراد جماعي غير متزامن - تحميل ملف CSV/JSONL للأعضاء/الطلبات واستطلاع المهمة (بدون حد أقصى ١٠٠ صف)
/api/v2/members/import/api/v2/members/import/{id}/api/v2/orders/import/api/v2/orders/import/{id}بيانات الاختبار
1 نقطة النهايةبيانات وضع الاختبار في بيئة الاختبار المعزولة - حذف كل ما أنشأه مفتاح الاختبار
/api/v2/test-data/purgeحقول الملف الشخصي التنبؤية وتوصيات أكثر ذكاءً
تحديثان يتمّان داخل نقاط النهاية الحالية - لا توجد واجهة عامة جديدة، وتبقى استجابات نقاط نهاية التوصيات الحالية دون تغيير.
GET /api/v2/members/{id}/profileتتضمن الآن عمليات تجميع الملفات الشخصية الحقول التنبؤية، والتي يتم حسابها عندما تدعم بيانات الفريق التوافق:
- تاريخ الطلب التالي المتوقع - نموذج جاما مُلائم لكل عضو بناءً على فترات الشراء الخاصة به (يتطلب 3 عمليات شراء أو أكثر)، ويُعاد مع إحصائيات الفترات ومؤشر الثقة.
- احتمالية النقر على البريد الإلكتروني - إحصائية لوجستية مُنظَّمة من المستوى الثاني لكل فريق
P(click)من ميزات التفاعل التجميعية للملف الشخصي.
كلا الحقلين null يقعان أسفل بوابات الصدق - لا مجال للتخمين. يجب على المستهلكين التعامل مع null.
Recommendations (public embed + v2)تم تحديث نظام تقييم الشراء المشترك إلى مقياس تشابه المنتجات المُعدَّل بجيب التمام، بحيث لم يعد تأثير المنتجات الأكثر مبيعًا هو العامل الحاسم في قوة الشراء المشترك.
score = co_count / sqrt(buyers(A) × buyers(B)) # pairs need ≥2 shared buyers
# raw co_count still storedيتم تشغيل مهمة جديدة ليلية لكل فريق (الدعم / الثقة / الرفع؛ MIN_PAIR_ORDERS=3، MIN_CONFIDENCE=0.05، أفضل 25 قاعدة لكل سابقة حسب الرفع) وتُقدّم اقتراحات البيع المتبادل. تستمر عمليات التكامل الحالية بالعمل كما هي - أشكال الاستجابة لم تتغير.