في هذه الصفحة

توثيق API لوحة SMM

إصدار API: v2

يوفّر SmmFoxi واجهة API قياسية للوحة SMM (الإصدار v2) لتدمج 373 خدمة تسويق عبر وسائل التواصل مباشرةً في لوحة الموزّع أو البوت أو التطبيق لديك. بداية سريعة للخدمات المؤهلة وأسعار تنافسية وأتمتة كاملة. يغطّي هذا التوثيق جميع نقاط النهاية المتاحة وطريقة استخدامها.

قبل البدء: احصل على وصول API في 4 خطوات

تحتاج إلى حساب ورصيد مشحون ومفتاح API قبل أول طلب. يستغرق الإعداد بضع دقائق:

  1. 1

    أنشئ حسابًا

    سجّل حسابًا في SmmFoxi. يُستخدم الحساب نفسه في لوحة التحكم على الويب وفي API.

    التسجيل →
  2. 2

    اشحن رصيدك

    تُخصم طلبات API من رصيد حسابك. أضف الرصيد من لوحة التحكم، ويمكنك التحقق منه في أي وقت عبر action=balance.

    فتح لوحة التحكم →
  3. 3

    احصل على مفتاح API

    انتقل إلى «لوحة التحكم ← API» وأنشئ مفتاحًا. يُعرض كاملًا مرة واحدة فقط — انسخه واحفظه بأمان. عند تحديثه يتوقف المفتاح القديم فورًا.

    احصل على المفتاح →
  4. 4

    اربط واختبر

    أرسل طلبات POST إلى العنوان أدناه مع مفتاحك ومعامل action. ابدأ بـ action=services لجلب معرّفات الخدمات والأسعار، ثم نفّذ طلبًا تجريبيًا صغيرًا.

    عنوان API →

عنوان API

https://smmfoxi.com/api/v2

يجب إرسال جميع الطلبات إلى هذا العنوان عبر طريقة POST أو GET.

المصادقة

تتطلب جميع طلبات API المصادقة باستخدام مفتاح API الخاص بك. أنشئه من «لوحة التحكم ← API» (يُعرض المفتاح كاملًا مرة واحدة فقط، فاحفظه فورًا). أرسل المعامل key مع كل طلب.

POST https://smmfoxi.com/api/v2
Content-Type: application/json

{
  "key": "YOUR_API_KEY",
  "action": "services"
}

تنسيق الاستجابة

يتم إرجاع جميع الاستجابات بتنسيق JSON. تُرجع الطلبات الناجحة البيانات المطلوبة، بينما تُرجع الأخطاء كائن خطأ مع الوصف.

نقاط النهاية API

الحصول على الخدمات

يُرجع قائمة بجميع الخدمات المتاحة مع تفاصيلها بما في ذلك الأسعار والكميات الدنيا والقصوى.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "services"
// مثال على الاستجابة
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.90",
    "min": "100",
    "max": "10000",
    "refill": true,
    "cancel": true
  }
]

الحصول على الرصيد

يُرجع رصيد حسابك الحالي والعملة.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "balance"
// مثال على الاستجابة
{
  "balance": "100.84292",
  "currency": "USD"
}

إضافة طلب

إنشاء طلب جديد لخدمة. تعتمد المعلمات المطلوبة على نوع الخدمة.

النوع الافتراضي

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "add"
  • service - معرف الخدمة (مطلوب)
  • link - عنوان URL المستهدف (مطلوب)
  • quantity - كمية الطلب (مطلوب)

نوع الباقة

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "add"
  • service - معرف الخدمة (مطلوب)
  • link - عنوان URL المستهدف (مطلوب)

نوع التعليقات المخصصة

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "add"
  • service - معرف الخدمة (مطلوب)
  • link - عنوان URL المستهدف (مطلوب)
  • comments - التعليقات مفصولة بسطر جديد (مطلوب)
// مثال على الاستجابة
{
  "order": 23501
}

حالة الطلب

الحصول على حالة طلب واحد أو أكثر. يمكنك الاستعلام عن طلب واحد أو عدة طلبات في وقت واحد.

طلب واحد

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "status"
  • order - معرف الطلب (مطلوب)

طلبات متعددة (حتى 100)

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "status"
  • orders - معرفات الطلبات مفصولة بفاصلة (مطلوب)
// مثال على الاستجابة
{
  "charge": "0.27819",
  "start_count": "3572",
  "status": "Completed",
  "remains": "0",
  "currency": "USD"
}

إنشاء إعادة تعبئة

طلب إعادة تعبئة لطلب. متاح فقط للخدمات التي تدعم إعادة التعبئة.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "refill"
  • order - معرف الطلب (مطلوب)
// مثال على الاستجابة
{
  "refill": "1"
}

حالة إعادة التعبئة

التحقق من حالة طلب إعادة التعبئة.

المعلمات

  • key - مفتاح API الخاص بك (مطلوب)
  • action - "refill_status"
  • refill - معرف إعادة التعبئة (مطلوب)
// مثال على الاستجابة
{
  "status": "Completed"
}

حالات الطلب

  • Pending - الطلب في انتظار المعالجة
  • Processing - الطلب قيد التحضير
  • In progress - الطلب قيد التنفيذ حالياً
  • Completed - تم إكمال الطلب بنجاح
  • Partial - تم إكمال الطلب جزئياً (تم استرداد المبلغ المتبقي)
  • Canceled - تم إلغاء الطلب

معالجة الأخطاء

عند حدوث خطأ، يُرجع API كائن JSON مع حقل error يصف المشكلة.

// مثال على استجابة الخطأ
{
  "error": "Invalid API key"
}

حدود المعدل

لضمان جودة الخدمة، تنطبق حدود المعدل التالية:

  • 5 طلبات في الثانية
  • 100 طلب في الدقيقة
  • 1000 طلب في الساعة