انتقل إلى المحتوى
تسجيل الدخولالتسجيل

واجهة API للوحة SMM: الخدمات والطلبات والحالة والرصيد

تستخدم واجهة SMMHO صيغة API v2 الشائعة في لوحات SMM. أرسل طلب POST إلى عنوان واحد، وحدد المهمة بقيمة action، وستحصل على رد بصيغة JSON.

أساسيات API

العنوان
POST https://smmho.com/api/v2
صيغة الطلب
application/x-www-form-urlencoded أو application/json
المصادقة
مفتاح API في الحقل key. أنشئه من صفحة الحساب بعد تسجيل الدخول
الرد
بصيغة JSON. الطلبات الفاشلة تعيد السبب في الحقل error
حد الطلبات
300 طلب في الدقيقة لكل مفتاح
أنشئ مفتاح APIأنشئ مفتاح API من صفحة الحساب بعد تسجيل الدخول.
curl https://smmho.com/api/v2 \  -d "key=YOUR_API_KEY" \  -d "action=add" -d "service=9340" \  -d "link=https://instagram.com/me" \  -d "quantity=1000"
// { "order": "TT5M-CA9L" }

إجراءات API للوحة SMM

action=servicesقائمة الخدمات

تعيد كل خدمة مع رقمها واسمها وفئتها وسعر 1,000 والحد الأدنى والأقصى للكمية، وهل فيها تعويض.

المعاملات
الاسمالوصف
keyمفتاح API
actionservices

مثال على الرد

[
  {
    "service": 9340,
    "name": "Instagram Followers, 30-day refill",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "2.2470",
    "min": 50,
    "max": 75000,
    "refill": true,
    "cancel": true
  }
]

action=addطلب جديد

تقدّم طلباً برقم الخدمة والرابط والكمية. تُخصم التكلفة من رصيدك ويُعاد رمز الطلب.

المعاملات
الاسمالوصف
keyمفتاح API
actionadd
serviceرقم الخدمة
linkرابط الحساب أو المنشور
quantityالكمية (ضمن الحد الأدنى والأقصى للخدمة)

مثال على الرد

{
  "order": "TT5M-CA9L"
}

action=statusحالة الطلب

تعيد التكلفة والعدد الابتدائي والحالة والكمية المتبقية لرمز طلب واحد (order) أو لحتى 100 رمز مفصولة بفواصل (orders).

المعاملات
الاسمالوصف
keyمفتاح API
actionstatus
orderرمز طلب واحد
ordersعدة رموز طلبات (مفصولة بفواصل، حتى 100)

مثال على الرد

{
  "charge": "2.2470",
  "start_count": 0,
  "status": "Pending",
  "remains": 1000,
  "currency": "USD"
}

action=balanceالرصيد

تعيد رصيدك الحالي والعملة.

المعاملات
الاسمالوصف
keyمفتاح API
actionbalance

مثال على الرد

{
  "balance": "100.0000",
  "currency": "USD"
}

action=cancelإلغاء الطلبات

تلغي الطلبات المعلقة. وتعود التكلفة إلى رصيدك.

المعاملات
الاسمالوصف
keyمفتاح API
actioncancel
ordersرموز الطلبات (مفصولة بفواصل، حتى 100)

مثال على الرد

[
  {
    "order": "TT5M-CA9L",
    "cancel": 1
  }
]

action=refillطلب التعويض

تطلب تعويضاً لطلب مكتمل أو جزئي ما زال ضمن مدة التعويض. ويُعاد رمز الطلب.

المعاملات
الاسمالوصف
keyمفتاح API
actionrefill
orderرمز الطلب

مثال على الرد

{
  "refill": "RK7QM-2XWD"
}

قيم حالة الطلب

Pending
لم يبدأ بعد، ويمكن إلغاؤه
In progress
قيد التنفيذ
Completed
نُفِّذ بالكامل
Partial
نُفِّذ جزئياً. ويعود الجزء غير المنفذ إلى الرصيد
Canceled
ملغى. وتعود التكلفة إلى الرصيد

أخطاء API

Invalid API key
المفتاح خاطئ أو تم استبداله بمفتاح جديد
Invalid service
لا توجد خدمة بهذا الرقم
Invalid link
ليس عنواناً عاماً يبدأ بـ https://
Quantity out of range
الكمية خارج الحد الأدنى والأقصى للخدمة
Not enough funds on balance
رصيدك غير كافٍ
Too many requests
تم بلوغ حد الطلبات. أعد الإرسال بعد قليل
Refill already requested
يوجد طلب تعويض مفتوح لهذا الطلب
Refill is not available for this order
الخدمة بلا تعويض أو انتهت مدة التعويض