API
توثيق API
طلب POST واحد لكل شيء: الطلب، الحالة، قائمة الخدمات، الرصيد. متوافق مع Perfect Panel وSmartPanel.
https://stream-promotion.ru/api/v2POSTJSONUSDافتراضيًا، ويمكن تغييرها من الإعدادات- أُرسل الطلب بطريقة GET. لا يُقبل سوى POST.
- وُضعت المعاملات في سطر العنوان. يجب إرسالها في جسم الطلب لا في query.
- لم يُحدَّد User-Agent. عند الاختبار عبر Postman أو curl حدِّده صراحةً.
أنت مسؤول عمّا ترسله عبر API. اقرأ وصف الطرق قبل الربط.
كيفية الحصول على المفتاح
- سجّل الدخول إلى حسابك.
- افتح قسم «إعدادات API».
- انسخ المفتاح والعنوان وأضفهما إلى لوحتك.
تأتي قائمة الخدمات باللغة المحددة في إعدادات API. ويمكن اختيار عملة الأسعار من المكان نفسه — الافتراضي USD.
بداية سريعة
تحقّق من الاتصال بطلب الرصيد — فهو الأبسط ولا يُنشئ شيئًا.
curl -X POST https://stream-promotion.ru/api/v2 \ -H "User-Agent: MyPanel/1.0" \ -d "key=مفتاحك" \ -d "action=balance"
<?php
$ch = curl_init('https://stream-promotion.ru/api/v2');
curl_setopt($ch, CURLOPT_POST, true);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_USERAGENT, 'MyPanel/1.0');
curl_setopt($ch, CURLOPT_POSTFIELDS, http_build_query([
'key' => 'مفتاحك',
'action' => 'balance',
]));
$res = json_decode(curl_exec($ch), true);
curl_close($ch);
print_r($res); import requests
res = requests.post(
"https://stream-promotion.ru/api/v2",
data={"key": "مفتاحك", "action": "balance"},
headers={"User-Agent": "MyPanel/1.0"},
timeout=30,
)
print(res.json()) const res = await fetch("https://stream-promotion.ru/api/v2", {
method: "POST",
headers: {
"Content-Type": "application/x-www-form-urlencoded",
"User-Agent": "MyPanel/1.0",
},
body: new URLSearchParams({
key: "مفتاحك",
action: "balance",
}),
});
console.log(await res.json()); الاستجابة
{
"status": "success",
"balance": "0.03",
"currency": "USD"
} الطرق
تُختار الطريقة بالمعامل action. والمفتاح key مطلوب دائمًا.
إنشاء طلب
الطريقة الأساسية. يُستخدم runs وinterval للتسليم على دفعات: 7 مرات بفاصل 1440 دقيقة تمدّ الطلب على أسبوع.
تعتمد مجموعة المعاملات على نوع الخدمة — اختر النوع من القائمة وسيتحدّث الجدول.
| المعامل | الوصف |
|---|---|
keyمطلوب | مفتاحك من إعدادات API |
actionمطلوب | add |
serviceمطلوب | معرّف الخدمة من القائمة |
linkمطلوب | رابط القناة أو البث أو الصفحة |
quantityمطلوب | الكمية |
runsاختياري | عدد مرات التشغيل |
intervalاختياري | الفاصل بين مرات التشغيل بالدقائق. عدد صحيح: 10، 20، 30، 60 |
الاستجابة
{
"status": "success",
"order": 32
}طلب مع تعليقات
نوع منفصل من الطلبات: بدل الكمية تُرسل قائمة تعليقات. مناسب للإشارات والتعليقات المخصصة.
| المعامل | الوصف |
|---|---|
keyمطلوب | مفتاحك من إعدادات API |
actionمطلوب | add |
serviceمطلوب | معرّف الباقة |
linkمطلوب | رابط القناة أو البث أو الصفحة |
commentsمطلوب | التعليقات، كل تعليق في سطر |
الاستجابة
{
"status": "success",
"order": 32
}حالة الطلب
| المعامل | الوصف |
|---|---|
keyمطلوب | مفتاحك من إعدادات API |
actionمطلوب | status |
orderمطلوب | معرّف الطلب |
الاستجابة
{
"order": "32",
"status": "pending",
"charge": "0.27819",
"start_count": "0",
"remains": "0",
"currency": "USD"
}حالات عدة طلبات
حتى مئة طلب في طلب واحد بدل مئة نداء منفصل.
| المعامل | الوصف |
|---|---|
keyمطلوب | مفتاحك من إعدادات API |
actionمطلوب | status |
ordersمطلوب | المعرّفات مفصولة بفواصل: 12,13,14 |
الاستجابة
{
"12": {
"order": "12",
"status": "completed",
"charge": "0.27819",
"currency": "USD"
},
"13": {
"error": "Incorrect order ID"
}
}قائمة الخدمات
تُعيد كل الخدمات المتاحة مع الأسعار. لغة الأسماء من إعدادات API، والأسعار دائمًا بالدولار.
| المعامل | الوصف |
|---|---|
keyمطلوب | مفتاحك من إعدادات API |
actionمطلوب | services |
الاستجابة
[
{
"service": "5",
"name": "Instagram Followers",
"rate": "0.9",
"min": "50",
"max": "10000",
"type": "Default",
"category": "Instagram"
}
]الرصيد
أبسط الطرق — مناسبة للتحقق من أن المفتاح يعمل.
| المعامل | الوصف |
|---|---|
keyمطلوب | مفتاحك من إعدادات API |
actionمطلوب | balance |
الاستجابة
{
"status": "success",
"balance": "0.03",
"currency": "USD"
}الأخطاء
عند الفشل تتضمّن الاستجابة الحقل error مع وصف. ويبقى رمز HTTP هو 200 — تحقّق من جسم الاستجابة لا من حالة الاتصال.
{
"error": "Incorrect request"
} نبني لك لوحة متكاملة على خدماتنا. الرصيد والأسعار بالدولار، متوافق مع Perfect Panel وSmartPanel.
راسلنا على تيليجرام
خدماتنا للبث المباشر
Shopee
خدماتنا لصانعي المحتوى
