SMM Panel API v2

توثيق API الرسمي

اربط منصتك مع خدماتنا بسهولة — نفس معيار SMM Panel API القياسي المتوافق مع جميع برامج إعادة البيع

POSThttps://viralwave.top/api/v2
HTTPS مشفر
60 طلب/دقيقة
JSON + form-data
99.9% uptime

1
البداية السريعة

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

من لوحة التحكم → API → انسخ مفتاحك

اجلب الخدمات

أرسل action=services لترى كل الخدمات والأسعار

أنشئ طلبك

أرسل action=add مع معرّف الخدمة والكمية والرابط

مثال كامل (cURL)

bash
# 1. جلب الخدمات
curl -X POST https://viralwave.top/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"services"}'

# 2. إنشاء طلب
curl -X POST https://viralwave.top/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"add","service":"SERVICE_ID","link":"https://instagram.com/username/","quantity":1000}'

# 3. تتبع الحالة
curl -X POST https://viralwave.top/api/v2 \
  -H "Content-Type: application/json" \
  -d '{"key":"YOUR_API_KEY","action":"status","order":"ORDER_ID"}'

2
نقاط النهاية (Endpoints)

3
حالات الطلب

الحالةالمعنى
Pendingالطلب في قائمة الانتظار
In progressجاري التنفيذ حالياً
Completedاكتمل بنجاح ✓
Partialاكتمل جزئياً (رصيد الفرق يُسترد تلقائياً)
Canceledملغي (الرصيد مُسترد)
Failedفشل في التنفيذ

4
رسائل الخطأ

جميع الأخطاء تُرجع JSON بصيغة: { "error": "..." }

رسالة الخطأالسبب
API key is requiredلم يتم إرسال مفتاح API
Invalid API keyمفتاح API غير صحيح أو الحساب معطل
Action is requiredلم يتم تحديد الـ action
Unknown action: Xالـ action غير معروف
Service not found or inactiveالخدمة غير موجودة أو غير نشطة
Insufficient balanceالرصيد غير كافٍ
Quantity must be between X and Yالكمية خارج النطاق المسموح
Invalid linkالرابط غير صالح أو لا يبدأ بـ https://
All providers unavailableجميع المزودين غير متاحين — أعد المحاولة لاحقاً
Too many requestsتجاوزت 60 طلب/دقيقة — انتظر ثم أعد المحاولة

5
حساب التكلفة والحدود

حد الطلبات (Rate Limit)

  • 60 طلب API في الدقيقة لكل مفتاح
  • لا حد لعدد الطلبات (orders) يومياً
  • تجاوز الحد يُرجع خطأ 429

حساب تكلفة الطلب

  • التكلفة = (quantity ÷ 1000) × rate
  • مثال: 1000 متابع × $0.35 = $0.35
  • الرصيد يُخصم فور إنشاء الطلب
  • الطلبات الفاشلة تُسترد تلقائياً

جاهز للبدء؟

سجّل الآن واحصل على مفتاح API مجاناً

إنشاء حساب مجانيإدارة مفتاح API