موثّق ومباشر

توثيق الـ API

أتمتة طلباتك وإدارة حسابك بالكامل عبر واجهة برمجة تطبيقات بسيطة ومتوافقة مع المعايير.

1

المصادقة

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


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

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

POST services الحصول على جميع الخدمات المتاحة
مثال الطلب 
POST https://nafazsmm.store/api/v2

key=YOUR_API_KEY
action=services
الاستجابة 
[
  {
    "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://nafazsmm.store/api/v2

key=YOUR_API_KEY
action=balance
الاستجابة 
{
  "balance": "98.54200",
  "currency": "USD"
}
4

إضافة طلب

يُحتسب السعر كالتالي: (quantity / 1000) × rate. ويُخصم من رصيدك فورًا.
POST add طلب افتراضي
المعامل النوع الوصف
keyمطلوبstringمفتاح الـ API الخاص بك
actionمطلوبstringadd
serviceمطلوبintegerمعرّف الخدمة
linkمطلوبstringرابط الصفحة أو المنشور
quantityمطلوبintegerالكمية (بين الحد الأدنى والأقصى للخدمة)
runsاختياريintegerعدد مرات التنفيذ (تنفيذ متدرج)
delayاختياريintegerالفاصل الزمني بين كل تنفيذ بالدقائق
مثال الطلب 
key=YOUR_API_KEY
action=add
service=1
link=https://instagram.com/username
quantity=1000

// Response
{ "order": 23501 }
POST add طلب تعليقات مخصصة
المعامل النوع الوصف
serviceمطلوبintegerمعرّف الخدمة (نوع تعليقات مخصصة)
linkمطلوبstringرابط المنشور
commentsمطلوبstringالتعليقات — تعليق واحد في كل سطر
مثال الطلب 
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 طلب اشتراكات
المعامل النوع الوصف
serviceمطلوبintegerمعرّف خدمة الاشتراكات
usernameمطلوبstringاسم المستخدم (بدون @)
minمطلوبintegerالحد الأدنى لعدد المتابعين
maxمطلوبintegerالحد الأقصى لعدد المتابعين
postsمطلوبintegerعدد المنشورات
delayمطلوبintegerالفاصل الزمني بالدقائق
5

حالة الطلب

POST status طلب واحد أو عدة طلبات
المعامل النوع الوصف
orderاختياريintegerمعرّف الطلب (طلب واحد)
ordersاختياريstringمعرّفات مفصولة بفواصل (حتى 100)
الاستجابة — طلب واحد 
{
  "charge":      "0.50000",
  "start_count": "1200",
  "status":      "Completed",
  "remains":     "0",
  "currency":    "USD"
}
الاستجابة — عدة طلبات 
{
  "23501": { "status": "Completed", "remains": "0", ... },
  "23502": { "status": "In progress", "remains": "500", ... },
  "99999": { "error": "Incorrect order ID" }
}

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

  • ● قيد الانتظار
  • ● قيد المعالجة
  • ● نشط
  • ● مكتمل
  • ● جزئي
  • ● ملغي
  • ● فشل
6

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

إعادة التعبئة متاحة فقط للطلبات Completed وللخدمات التي تدعمها (refill: true).
POST refill إنشاء طلب إعادة تعبئة
المعامل النوع الوصف
orderاختياريintegerمعرّف إعادة التعبئة (طلب واحد)
ordersاختياريstringمعرّفات مفصولة بفواصل
الاستجابة 
{ "refill": 9901 }
الاستجابة 
[
  { "order": 23501, "refill": 9901 },
  { "order": 23502, "refill": { "error": "Refill not available" } }
]
POST refill_status حالة إعادة التعبئة
المعامل النوع الوصف
refillاختياريintegerمعرّف إعادة التعبئة (طلب واحد)
refillsاختياريstringمعرّفات مفصولة بفواصل
الاستجابة 
// Single
{ "status": "Completed" }

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

إلغاء طلب واحد أو عدة طلبات

الإلغاء متاح فقط للطلبات Pending وللخدمات التي تدعمه (cancel: true).
POST cancel إلغاء طلب واحد أو عدة طلبات
المعامل النوع الوصف
ordersمطلوبstringمعرّف طلب واحد أو عدة معرّفات مفصولة بفواصل
الاستجابة 
[
  { "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قيمة إجراء غير معروفة
احصل على مفتاح API الآن