الانتقال إلى المحتوى

مرجع API

يعمل 1PANEL PLUS بصيغة API v2 القياسية للوحات SMM. أرسل طلب POST يحتوي على مفتاح API وإجراء، وكل رد يكون بصيغة JSON. الأسعار والرصيد هي نفسها كما في الموقع.

الأساسيات

نقطة الاتصال
https://1panelplus.com/api/v2
الطريقة
POST
المعاملات
حقول نموذج أو جسم JSON
مفتاح API الخاص بك
من صفحة مفتاح API في لوحة التحكم
حد الطلبات
300 طلب في الدقيقة لكل مفتاح

مثال على الطلب

curl -X POST https://1panelplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

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

جميع الخدمات النشطة. rate هو السعر لكل 1,000 بالدولار الأمريكي، أو سعر باقة واحدة عندما تكون قيمة type هي Package.

المعاملالوصف
keyمفتاح API الخاص بك
actionservices

مثال على الرد

[
  {
    "service": 1204,
    "name": "YouTube Views - 30 Days Refill",
    "type": "Default",
    "category": "YouTube - Views (30 Days Refill)",
    "rate": "1.5600",
    "min": "100",
    "max": "1000000",
    "refill": true,
    "cancel": false
  }
]

إضافة طلب

يقدّم طلبًا ويخصم سعره من رصيدك. في Custom Comments، أرسل comments (تعليق في كل سطر) بدلًا من quantity.

المعاملالوصف
keyمفتاح API الخاص بك
actionadd
serviceمعرّف الخدمة
linkرابط الفيديو أو Short أو البث أو القناة
quantityالكمية (لا تُستخدم مع Custom Comments أو Package)
commentsلـ Custom Comments فقط: تعليق في كل سطر

مثال على الرد

{
  "order": 23501
}

حالة الطلب

حالة طلب واحد. charge هو المبلغ الذي دفعته بالدولار الأمريكي.

المعاملالوصف
keyمفتاح API الخاص بك
actionstatus
orderمعرّف الطلب

مثال على الرد

{
  "charge": "1.560000",
  "start_count": "3572",
  "status": "In progress",
  "remains": "157",
  "currency": "USD"
}

حالة عدة طلبات

حالة ما يصل إلى 100 طلب، مفصولة بفواصل.

المعاملالوصف
keyمفتاح API الخاص بك
actionstatus
ordersمعرّفات الطلبات، مثلًا 1,10,100

مثال على الرد

{
  "1": { "charge": "0.270000", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

التعويض

يطلب تعويضًا لطلب منتهٍ في خدمة لها تعويض.

المعاملالوصف
keyمفتاح API الخاص بك
actionrefill
orderمعرّف الطلب

مثال على الرد

{
  "refill": 412
}

حالة التعويض

حالة طلب التعويض.

المعاملالوصف
keyمفتاح API الخاص بك
actionrefill_status
refillمعرّف التعويض

مثال على الرد

{
  "status": "Completed"
}

الرصيد

رصيدك بالدولار الأمريكي.

المعاملالوصف
keyمفتاح API الخاص بك
actionbalance

مثال على الرد

{
  "balance": "100.840000",
  "currency": "USD"
}

حالات الطلب

Pendingتم الاستلام، وينتظر البدء
In progressجارٍ التسليم
Completedسُلّم بالكامل
Partialسُلّم جزء، ورُدّ الباقي إلى رصيدك
Canceledلم يُسلَّم، ورُدّ المبلغ كاملًا

الأخطاء

تعود الأخطاء بصيغة JSON مع رسالة خطأ، مثلًا:

{
  "error": "Not enough funds on balance"
}
Invalid API keyالمفتاح مفقود أو خاطئ أو تم استبداله
Incorrect service IDلا توجد خدمة نشطة بهذا المعرّف
Incorrect linkالرابط فارغ أو ليس عنوان ويب
Quantity out of rangeأقل من الحد الأدنى أو أكثر من الحد الأقصى للخدمة
Not enough funds on balanceأضف رصيدًا أولًا
Too many requestsأكثر من 300 طلب في الدقيقة