موثق ومُحدَّث

توثيق الـ API

أتمتة طلباتك وأدِر حسابك بالكامل عبر API بسيط ومتوافق مع المعايير القياسية.

1

المصادقة

يستخدم الـ API مفاتيح API Key للمصادقة. يمكنك إنشاء مفتاحك من لوحة التحكم تحت قسم "API". أرسل المفتاح في كل طلب عبر أحد الطريقتين:


  • Header: أرسل Authorization: Bearer YOUR_API_KEY
  • Body parameter: أرسل key=YOUR_API_KEY ضمن بيانات الطلب
لا تشارك مفتاح الـ API مع أحد. في حال تسرّبه، احذفه فوراً وأنشئ مفتاحاً جديداً.
جميع الطلبات POST ويجب أن تحتوي على Content-Type: application/x-www-form-urlencoded أو application/json. جميع الردود بصيغة JSON.
2

قائمة الخدمات

POST services جلب كل الخدمات المتاحة
مثال على الطلب 
POST https://t.smmxcel.shop/api/v2

key=YOUR_API_KEY
action=services
Response 
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "0.50",    // USD per 1000
    "min": 100,
    "max": 10000,
    "refill": true,
    "cancel": false,
    "description": "High quality followers..."
  }
]
3

الرصيد

POST balance جلب رصيد حسابك
مثال على الطلب 
POST https://t.smmxcel.shop/api/v2

key=YOUR_API_KEY
action=balance
Response 
{
  "balance": "98.54200",
  "currency": "USD"
}
4

إنشاء طلب

السعر محتسب بالصيغة: (quantity / 1000) × rate. يُخصم من رصيدك فوراً.
POST add طلب عادي (Default)
المعامل النوع الوصف
keyRequiredstringمفتاح الـ API
actionRequiredstringadd
serviceRequiredintegerرقم ID الخدمة
linkRequiredstringرابط الصفحة أو المنشور
quantityRequiredintegerالكمية المطلوبة (بين min و max الخدمة)
runsOptionalintegerعدد مرات التشغيل (Drip Feed)
delayOptionalintegerالتأخير بين الـ runs بالدقائق
مثال 
key=YOUR_API_KEY
action=add
service=1
link=https://instagram.com/username
quantity=1000

// Response
{ "order": 23501 }
POST add طلب تعليقات مخصصة (Custom Comments)
المعامل النوع الوصف
serviceRequiredintegerID الخدمة (نوع Custom Comments)
linkRequiredstringرابط المنشور
commentsRequiredstringالتعليقات — كل تعليق في سطر جديد
مثال 
key=YOUR_API_KEY
action=add
service=15
link=https://instagram.com/p/ABC123
comments=Amazing post!\nLove this content!\nGreat work!

// Response
{ "order": 23502 }
POST add طلب اشتراكات (Subscriptions)
المعامل النوع الوصف
serviceRequiredintegerID خدمة الاشتراكات
usernameRequiredstringاسم المستخدم (بدون @)
minRequiredintegerالحد الأدنى من المتابعين
maxRequiredintegerالحد الأقصى من المتابعين
postsRequiredintegerعدد المنشورات
delayRequiredintegerالتأخير بالدقائق
5

حالة الطلب

POST status طلب واحد أو متعدد
المعامل النوع الوصف
orderOptionalintegerرقم الطلب (لطلب واحد)
ordersOptionalstringأرقام الطلبات مفصولة بفاصلة (حتى 100)
Response — Single 
{
  "charge":      "0.50000",
  "start_count": "1200",
  "status":      "Completed",
  "remains":     "0",
  "currency":    "USD"
}
Response — Multiple 
{
  "23501": { "status": "Completed", "remains": "0", ... },
  "23502": { "status": "In progress", "remains": "500", ... },
  "99999": { "error": "Incorrect order ID" }
}

حالات الطلب الممكنة

  • ● Pending
  • ● In progress
  • ● Active
  • ● Completed
  • ● Partial
  • ● Canceled
  • ● Failed
6

إعادة التعبئة (Refill)

إعادة التعبئة متاحة فقط للطلبات المكتملة (Completed) والخدمات التي تدعم الخاصية (refill: true).
POST refill طلب إعادة تعبئة
المعامل النوع الوصف
orderOptionalintegerرقم الطلب (طلب واحد)
ordersOptionalstringأرقام متعددة مفصولة بفاصلة
Response 
{ "refill": 9901 }
Response 
[
  { "order": 23501, "refill": 9901 },
  { "order": 23502, "refill": { "error": "Refill not available" } }
]
POST refill_status حالة إعادة التعبئة
المعامل النوع الوصف
refillOptionalintegerرقم الـ refill (طلب واحد)
refillsOptionalstringأرقام متعددة مفصولة بفاصلة
Response 
// Single
{ "status": "Completed" }

// Multiple
[
  { "refill": 9901, "status": "Completed" },
  { "refill": 9902, "status": "Pending" }
]
7

إلغاء الطلب

الإلغاء متاح فقط للطلبات بحالة Pending والخدمات التي تدعمه (cancel: true).
POST cancel إلغاء طلب أو أكثر
المعامل النوع الوصف
ordersRequiredstringرقم أو أرقام الطلبات مفصولة بفاصلة
Response 
[
  { "order": 23501, "cancel": 1 },
  { "order": 23502, "cancel": { "error": "Cancel not available" } }
]
8

رسائل الخطأ

الخطأ الوصف
Unauthenticatedمفتاح API غير صحيح أو مفقود
This API key does not have permission for this actionالمفتاح لا يملك صلاحية هذه العملية
Service not found or inactiveالخدمة غير موجودة أو غير نشطة
Quantity must be between {min} and {max}الكمية خارج النطاق المسموح
Insufficient balanceالرصيد غير كافٍ
Incorrect order IDرقم الطلب غير صحيح أو لا يعود لحسابك
Refill not availableإعادة التعبئة غير متاحة لهذا الطلب
Cancel not availableالإلغاء غير متاح لهذا الطلب
Unknown actionقيمة action غير معروفة
احصل على مفتاح API الآن