Довідник API SMM-панелі v2
1PANEL PLUS підтримує стандартний API SMM-панелі v2. Надішліть POST-запит із вашим API-ключем і дією; кожна відповідь у форматі JSON. Ціни та баланс ті самі, що й на сайті.
Основи
- Endpoint
- 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: ціна за 1000 у USD або ціна одного пакета, якщо 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 | ID послуги |
| link | Посилання на відео, Short, трансляцію або канал |
| quantity | Кількість (не для Custom Comments чи Package) |
| comments | Лише для Custom Comments: один коментар у рядку |
Приклад відповіді
{
"order": 23501
}Статус замовлення
Статус одного замовлення. charge: сума, яку ви сплатили, у USD.
| Параметр | Опис |
|---|---|
| key | Ваш API-ключ |
| action | status |
| order | ID замовлення |
Приклад відповіді
{
"charge": "1.560000",
"start_count": "3572",
"status": "In progress",
"remains": "157",
"currency": "USD"
}Кілька статусів
Статус до 100 замовлень, через кому.
| Параметр | Опис |
|---|---|
| key | Ваш API-ключ |
| action | status |
| orders | ID замовлень, наприклад 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 | ID замовлення |
Приклад відповіді
{
"refill": 412
}Статус відновлення
Статус запиту на відновлення.
| Параметр | Опис |
|---|---|
| key | Ваш API-ключ |
| action | refill_status |
| refill | ID відновлення |
Приклад відповіді
{
"status": "Completed"
}Баланс
Ваш баланс у USD.
| Параметр | Опис |
|---|---|
| key | Ваш API-ключ |
| action | balance |
Приклад відповіді
{
"balance": "100.840000",
"currency": "USD"
}Статуси замовлень
| Очікує | Отримано, очікує на запуск |
| Виконується | Доставляється |
| Виконано | Доставлено повністю |
| Частково | Доставлено частину; решту повернуто на баланс |
| Скасовано | Не доставлено; кошти повернуто повністю |
Помилки
Помилки повертаються у форматі JSON з повідомленням error, наприклад:
{
"error": "Not enough funds on balance"
}| Недійсний API-ключ | Ключ відсутній, неправильний або був замінений |
| Неправильний ID послуги | Немає активної послуги з цим ID |
| Неправильне посилання | Посилання порожнє або не є веб-адресою |
| Кількість поза допустимим діапазоном | Менше за мінімум або більше за максимум послуги |
| Недостатньо коштів на балансі | Спершу поповніть баланс |
| Забагато запитів | Понад 300 запитів за хвилину |