Future Force API — وثائق المطورين

مرحبًا بك في API الخاصة بـ Future Force

تسمح لك هذه الواجهات بالتحكم في الحملات، توليد المحتوى بالذكاء الاصطناعي، ربط المتاجر، وإدارة العملاء برمجيًا. يعتمد المصادقة على جلسات Supabase عبر كوكيز آمنة HttpOnly.

المصادقة

واجهات تسجيل الدخول والخروج وتحديد نوع المستخدم. تعتمد على جلسات Supabase عبر كوكيز آمنة.

POST/api/auth/user-typeمصادقة مطلوبة

تحديد نوع المستخدم بعد تسجيل الدخول

يُستخدم لتحديد ما إذا كان المستخدم عميلًا أو موظفًا، ويوجّهه إلى لوحة التحكم المناسبة.

Headers

Name	Value
Content-Type*	application/json

Body

{
  "type": "customer" | "admin"
}

Response 200

{
  "ok": true,
  "redirect": "/customers"
}

POST/api/auth/signoutمصادقة مطلوبة

تسجيل الخروج وإنهاء الجلسة

يُنهي جلسة Supabase الحالية ويمسح الكوكيز المرتبطة بها.

Response 200

{
  "ok": true
}

العملاء

واجهات لإدارة ملفات العملاء وبياناتهم داخل لوحة التحكم.

GET/api/v1/customersمصادقة مطلوبة

قائمة العملاء المسجّلين

يعرض قائمة العملاء المرتبطين بالحساب الحالي مع دعم الصفحات.

Response 200

{
  "customers": [
    { "id": "cus_123", "name": "متجر نور", "plan": "pro" }
  ],
  "total": 1
}

الحملات

إنشاء وإدارة الحملات الإعلانية على مختلف المنصات.

GET/api/campaignsمصادقة مطلوبة

عرض جميع الحملات

يُرجع قائمة الحملات الخاصة بالعميل الحالي مرتّبة حسب تاريخ الإنشاء.

Response 200

{
  "campaigns": [
    {
      "id": "cmp_01",
      "name": "حملة رمضان",
      "platform": "meta",
      "status": "قيد التشغيل"
    }
  ]
}

POST/api/campaignsمصادقة مطلوبة

إنشاء حملة إعلانية جديدة

ينشئ حملة جديدة بحالة «قيد الإعداد» ويُرجع معرّفها.

Headers

Name	Value
Authorization*	Bearer {token}
Content-Type*	application/json

Body

{
  "name": "حملة الصيف",
  "platform": "meta",
  "budget": 5000,
  "goal": "conversions"
}

Response 200

{
  "id": "cmp_02",
  "name": "حملة الصيف",
  "status": "قيد الإعداد"
}

المحتوى AI

واجهات توليد المحتوى التسويقي والصور بالذكاء الاصطناعي، ورفع الصور اليدوية.

POST/api/agents/contentمصادقة مطلوبة

توليد نص تسويقي بالذكاء الاصطناعي

يُنتج محتوى تسويقيًا مُخصّصًا بالعربية بناءً على اسم المنتج والجمهور المستهدف.

Headers

Name	Value
Content-Type*	application/json

Body

{
  "product": "عطر عود",
  "audience": "نساء من 25 إلى 40",
  "tone": "فاخر",
  "platform": "instagram"
}

Response 200

{
  "content": "رائحة تُشبهك... عود أصيل يصنع حضورك.",
  "hashtags": ["#عود", "#عطور_فاخرة"]
}

POST/api/agents/imageمصادقة مطلوبة

توليد صورة إعلانية عبر DALL·E 3

يُنشئ صورة إعلانية من وصف نصي ويُرجع رابط الصورة المُولَّدة.

Headers

Name	Value
Content-Type*	application/json

Body

{
  "prompt": "زجاجة عطر فاخرة على رمال ذهبية",
  "size": "1024x1024"
}

Response 200

{
  "url": "https://cdn.future-force.co/generated/abc.png",
  "revisedPrompt": "Luxury perfume bottle on golden sand..."
}

POST/api/agents/uploadمصادقة مطلوبة

رفع صورة يدويًا إلى المخزن

يستقبل ملف صورة ويُخزّنه في Supabase Storage ويُرجع الرابط العام.

Headers

Name	Value
Content-Type*	multipart/form-data

Body

FormData:
  file: (image/png | image/jpeg)

Response 200

{
  "url": "https://cdn.future-force.co/uploads/user_01/img.png",
  "size": 184320
}

المحفظة

إدارة الرصيد والاشتراكات والفواتير.

GET/api/v1/walletمصادقة مطلوبة

عرض رصيد المحفظة الحالي

Response 200

{
  "balance": 1250.75,
  "currency": "SAR",
  "plan": "pro"
}

التكاملات

روابط OAuth لربط حسابات Meta وسلة وزد مع حساب Future Force الخاص بك.

GET/api/integrations/meta/connectمصادقة مطلوبة

بدء ربط حساب Meta Ads

يُعيد توجيه المستخدم إلى صفحة OAuth الخاصة بميتا لمنح الصلاحيات.

Response 302

302 Redirect
Location: https://www.facebook.com/v18.0/dialog/oauth?...

GET/api/integrations/salla/connectمصادقة مطلوبة

بدء ربط متجر سلة

يبدأ تدفّق OAuth مع منصة سلة لربط المتجر.

Response 302

302 Redirect
Location: https://accounts.salla.sa/oauth2/auth?...

GET/api/integrations/zid/connectمصادقة مطلوبة

بدء ربط متجر زد

يبدأ تدفّق OAuth مع منصة زد لربط المتجر.

Response 302

302 Redirect
Location: https://oauth.zid.sa/authorize?...