API
Документація API
Один POST-запит на всі дії: замовлення, статус, список послуг, баланс. Сумісно з Perfect Panel і SmartPanel.
https://stream-promotion.ru/api/v2POSTJSONUSDза замовчуванням, змінюється в налаштуваннях- Запит надіслано методом GET. Приймається лише POST.
- Параметри передані в рядку адреси. Їх треба передавати в тілі запиту, не в query.
- Не задано User-Agent. Під час тестів через Postman чи curl вкажіть його явно.
Відповідальність за те, що ви надсилаєте через API, лежить на вашому боці. Прочитайте опис методів до підключення.
Як отримати ключ
- Увійдіть в особистий кабінет.
- Відкрийте розділ «Налаштування 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.
Написати в Telegram
Наші послуги для стрімерів
Shopee
Наші послуги для контент-мейкерів
