API
API v2 القياسي للوحات SMM. يمكن للأدوات واللوحات التي تدعم هذا التنسيق الاتصال باستخدام مفتاح API الخاص بك.
- نقطة الاتصال
- https://4xpanel.com/api/v2
- الطريقة
- POST. أرسل حقول النموذج (أو JSON) عبر POST. الإجابات بتنسيق JSON. تأتي الأخطاء بالشكل {"error": "..."}.
- مفتاح API
- أنشئه في صفحة مفتاح API بعد إضافة أول عملية شحن لك.
- الحدود
- 300 طلب في الدقيقة لكل مفتاح. يقبل status ما يصل إلى 100 معرّف طلب دفعة واحدة.
services
قائمة الخدمات
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | services |
مثال على الإجابة
[{"service":1,"name":"Video views","type":"Default","category":"TikTok - Views","rate":"0.0500","min":"100","max":"1000000","refill":true,"cancel":false}]add
تقديم طلب
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | add |
| service | معرّف الخدمة |
| link | الرابط |
| quantity | الكمية (ليست للباقات والتعليقات المخصّصة) |
| comments | تعليقات مخصّصة، واحد في كل سطر (خدمات التعليقات المخصّصة) |
مثال على الإجابة
{"order":23501}status
حالة الطلب
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | status |
| order | معرّف الطلب |
مثال على الإجابة
{"charge":"0.2500","start_count":"3572","status":"Partial","remains":"157","currency":"USD"}status (multiple)
حالة ما يصل إلى 100 طلب
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | status |
| orders | معرّفات الطلبات مفصولة بفواصل |
مثال على الإجابة
{"23501":{"charge":"0.2500","start_count":"3572","status":"Partial","remains":"157","currency":"USD"},"10":{"error":"Incorrect order ID"}}refill
طلب إعادة التعبئة
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | refill |
| order | معرّف الطلب |
مثال على الإجابة
{"refill":"1"}refill_status
حالة إعادة التعبئة
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | refill_status |
| refill | معرّف إعادة التعبئة |
مثال على الإجابة
{"status":"Completed"}balance
رصيد المحفظة
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | balance |
مثال على الإجابة
{"balance":"100.84","currency":"USD"}حالات الطلب
Pending, In progress, Completed, Partial, Canceled
حالات إعادة التعبئة
Pending, In progress, Completed, Rejected
الأخطاء
| الأخطاء | الوصف |
|---|---|
| Invalid API key | المفتاح خاطئ أو تم استبداله، أو لم تُضف أي عملية شحن بعد |
| Incorrect service ID | لا توجد خدمة متاحة للبيع بهذا المعرّف |
| Incorrect link | الرابط ليس عنوان ويب كاملًا |
| Quantity out of range | أقل من الحد الأدنى أو أعلى من الحد الأقصى |
| Not enough funds | رصيد المحفظة لا يغطي السعر |
| Too many requests | أكثر من 300 طلب في دقيقة |
| Refill not available | الخدمة بدون إعادة التعبئة، أو الطلب لم ينتهِ، أو انتهت الفترة، أو طُلبت إعادة التعبئة قبل أقل من 24 ساعة |
| Incorrect order ID | لا يوجد طلب خاص بك بهذا المعرّف |
| Incorrect refill ID | لا توجد إعادة تعبئة خاصة بك بهذا المعرّف |
| Incorrect comments | فارغة، أو أكثر من 10,000 سطر، أو سطر يتجاوز 500 حرف |
| Incorrect request | إجراء غير معروف |
| Bad request | تعذّرت قراءة نص الطلب |