مرجع 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 الخاص بك |
| action | services |
مثال على الرد
[
{
"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 الخاص بك |
| action | add |
| service | معرّف الخدمة |
| link | رابط الفيديو أو Short أو البث أو القناة |
| quantity | الكمية (لا تُستخدم مع Custom Comments أو Package) |
| comments | لـ Custom Comments فقط: تعليق في كل سطر |
مثال على الرد
{
"order": 23501
}حالة الطلب
حالة طلب واحد. charge هو المبلغ الذي دفعته بالدولار الأمريكي.
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | status |
| order | معرّف الطلب |
مثال على الرد
{
"charge": "1.560000",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}حالة عدة طلبات
حالة ما يصل إلى 100 طلب، مفصولة بفواصل.
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | status |
| orders | معرّفات الطلبات، مثلًا 1,10,100 |
مثال على الرد
{
"1": { "charge": "0.270000", "start_count": "3572", "status": "Partial", "remains": "157", "currency": "USD" },
"10": { "error": "Incorrect order ID" }
}التعويض
يطلب تعويضًا لطلب منتهٍ في خدمة لها تعويض.
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | refill |
| order | معرّف الطلب |
مثال على الرد
{
"refill": 412
}حالة التعويض
حالة طلب التعويض.
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | refill_status |
| refill | معرّف التعويض |
مثال على الرد
{
"status": "Completed"
}الرصيد
رصيدك بالدولار الأمريكي.
| المعامل | الوصف |
|---|---|
| key | مفتاح API الخاص بك |
| action | balance |
مثال على الرد
{
"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 طلب في الدقيقة |