للموزّعين

API الموزّعين

معيار SMM API v2. لو برنامج لوحتك بيتكلم مع مزوّد تاني، هيتكلم معانا.

الرابط

https://sco4m.com/api/v2

متوافق مع Perfect Panel وأي عميل مبني على نفس المواصفة.

المصادقة

كل طلب POST فيه مفتاح الـ API بتاعك و action. تقدر تنشئ المفتاح من صفحة حسابي في اللوحة. مفيش بيانات دخول منفصلة.

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

# الطلب
POST https://sco4m.com/api/v2
  key=YOUR_API_KEY
  action=services

# الرد
[
  {
    "service": "11",
    "name": "Instagram Followers",
    "type": "Default",
    "category": "Instagram",
    "rate": "25.0000",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": true
  }
]

إنشاء طلب

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

POST https://sco4m.com/api/v2
  key=YOUR_API_KEY
  action=add
  service=11
  link=https://instagram.com/username
  quantity=1000

# الرد
{ "order": 100023 }

الاستعلام عن الحالة

اسأل عن طلب واحد، أو لحد 100 طلب في نداء واحد. استخدم الشكل المجمّع: طلب HTTP لكل أوردر مش هيستحمل، والشكل المجمّع هو اللي اللوحة نفسها بتستخدمه داخلياً.

# طلب واحد
POST https://sco4m.com/api/v2  action=status  order=100023

{ "charge": "25.0000", "start_count": "12480",
  "status": "In progress", "remains": "3100",
  "currency": "EGP" }

# لحد 100 طلب في نداء واحد
POST https://sco4m.com/api/v2  action=status  orders=100023,100024,100025

{ "100023": { ... }, "100024": { "error": "Incorrect order ID" } }

كل الـ actions

action	المعاملات	بيرجّع
services	—	مصفوفة الخدمات بأسعارها
add	service, link, quantity	رقم الطلب
status	order \| orders	المبلغ، العدد الابتدائي، الحالة، المتبقي
balance	—	رصيدك والعملة
refill	order \| orders	رقم إعادة التعبئة
refill_status	refill	حالة إعادة التعبئة
cancel	orders	نتيجة لكل طلب

الأخطاء

الأخطاء بترجع بـ HTTP 200 ومعاها مفتاح error، مش 4xx. ده مقصود ومطابق للمواصفة اللي كل العملاء في السوق ده بينفّذوها: الـ 4xx بيخلي مكتبات كتير تعتبر النداء فشل شبكة وتعيده، وفي add ده معناه أوردر مكرر.

{ "error": "Not enough funds on balance" }   // HTTP 200

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

اعمل حساب، أنشئ المفتاح من صفحة حسابي، وابدأ تبعت طلبات.

اعمل حساب مجاني