Документація API

Автентифікація

Усі запити до API мають містити параметр key — ваш унікальний API ключ. Ключ можна знайти в розділі API вашої панелі.

POST запит

                                
POST https://palladium-smm.com/api/v2
Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&action=balance

GET запит

GET https://palladium-smm.com/api/v2?key=YOUR_API_KEY&action=balance

Ніколи не передавайте API ключ у клієнтському JavaScript. Використовуйте ключ лише на сервері.

balance Баланс

action=balance Повертає поточний баланс користувача

Параметри

Параметр	Тип
`key`	string	обов'язковий
`action`	string	обов'язковий

Відповідь

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

services Список послуг

action=services Повертає всі доступні послуги

Параметри

Параметр	Тип
`key`	string	обов'язковий
`action`	string	обов'язковий

Відповідь

                                
[
  {
    "service": 1,
    "name": "Instagram Followers",
    "type": "Default",
    "rate": "1.5000",
    "min": 100,
    "max": 10000,
    "refill": true,
    "cancel": false,
    "category": "Instagram",
    "description": ""
  }
]

rate — ціна за 1000 одиниць у USD.

add Створити замовлення

action=add action=create Створює нове замовлення, списує кошти з балансу

Параметри

Параметр	Тип	Опис
`key`	string	API ключ	обов'язковий
`action`	string	«add»	обов'язковий
`service`	integer	ID послуги	обов'язковий
`link`	string	URL / ціль замовлення	обов'язковий
`quantity`	integer	Кількість (не потрібно для типу Package)	необов'язково
`drip_feed`	boolean	Увімкнути drip-feed (1 або 0)	необов'язково
`runs`	integer	Кількість запусків (drip-feed)	необов'язково
`interval`	integer	Інтервал у хвилинах (drip-feed)	необов'язково
`comments`	string	Коментарі (Custom Comments)	необов'язково
`usernames`	string	Згадки (Mentions)	необов'язково
`hashtags`	string	Хештеги (Hashtags)	необов'язково
`answer_number`	integer	Номер відповіді (Poll)	необов'язково
`emoji`	string	Emoji-рядок (Emoji)	необов'язково

Приклад запиту

                                
POST https://palladium-smm.com/api/v2

key      = YOUR_API_KEY
action   = add
service  = 1
link     = https://instagram.com/user
quantity = 1000

Відповідь

{ "order": 12345 }

status Статус замовлення

action=status Отримати статус одного або кількох замовлень

Параметри

Параметр	Тип	Опис
`key`	string	API ключ	обов'язковий
`action`	string	«status»	обов'язковий
`order`	integer	ID одного замовлення	один з двох
`orders`	string	Кілька ID через кому: `1,2,3`	один з двох

Одне замовлення

                                
{
  "charge": "1.50",
  "start_count": "850",
  "status": "In progress",
  "remains": "400",
  "currency": "USD"
}

Кілька замовлень

                                
{
  "1": {
    "charge": "1.50",
    "start_count": "0",
    "status": "Pending",
    "remains": "0",
    "currency": "USD"
  },
  "2": {
    "error": "Incorrect order ID"
  }
}

Значення статусу

Pending In progress Completed Partial Canceled

cancel Скасувати замовлення

action=cancel Скасовує замовлення та повертає кошти на баланс

Параметри

Параметр	Тип	Опис
`key`	string	API ключ	обов'язковий
`action`	string	«cancel»	обов'язковий
`order`	integer	ID одного замовлення	один з двох
`orders`	string	Кілька ID через кому	один з двох

Одне замовлення

{ "cancel": 1 }

Кілька замовлень

                                
{
  "1": { "cancel": 1 },
  "3": {
    "error": "Order is already completed"
  }
}

refill Запросити Refill

action=refill Запитує поповнення (refill) для завершеного замовлення

Параметри

Параметр	Тип	Опис
`key`	string	API ключ	обов'язковий
`action`	string	«refill»	обов'язковий
`order`	integer	ID одного замовлення	один з двох
`orders`	string	Кілька ID через кому	один з двох

Одне замовлення

{ "refill": 12345 }

Кілька замовлень

                                
{
  "1": { "refill": 101 },
  "2": {
    "error": "Refill is not available for this order"
  }
}

refill_status Статус Refill

action=refill_status Перевіряє статус запиту на refill

Параметри

Параметр	Тип	Опис
`key`	string	API ключ	обов'язковий
`action`	string	«refill_status»	обов'язковий
`refill`	integer	ID запиту refill	один з двох
`refills`	string	Кілька ID через кому	один з двох

Відповідь

{ "status": "Completed" }

Значення статусу

"In progress"  — виконується
"Completed"    — завершено
"Partial"      — частково
"Rejected"     — відхилено

Типи послуг

Поле type в послузі визначає набір додаткових параметрів, які потрібно передати при створенні замовлення.

Тип	Дод. параметри	Опис
`Default`	—	Стандартний. Лише `link` та `quantity`
`Custom Comments`	`comments`	Список коментарів, кожен з нового рядка
`Package`	—	Фіксований пакет, `quantity` не потрібен
`Mentions`	`usernames`	Список @usernames по одному на рядок
`Mentions with Hashtags`	`usernames`, `hashtags`	Згадки + хештеги
`Hashtags`	`hashtags`	Список #hashtags по одному на рядок
`Poll`	`answer_number`	Номер варіанту відповіді (з 1)
`Emoji`	`emoji`	Emoji-рядок, наприклад `❤️🔥`

Помилки

У разі помилки API завжди повертає HTTP 200 з JSON, що містить ключ error.

{ "error": "Incorrect API key" }

Повідомлення	Причина
`Incorrect API key`	Ключ не знайдено або невірний
`Your account is banned`	Акаунт заблоковано
`Incorrect action`	Невідоме значення `action`
`Incorrect parameters`	Не передано `service` або `link`
`Incorrect service ID`	Послуга не знайдена або вимкнена
`Incorrect order ID`	Замовлення не знайдено або чуже
`Incorrect refill ID`	Refill-запит не знайдено або він належить іншому користувачу
`Not enough funds on balance`	Недостатньо коштів
`Quantity must be between X and Y`	Кількість поза діапазоном
`Runs must be at least 1`	drip-feed: кількість запусків має бути ≥ 1
`Interval must be at least 1 minute`	drip-feed: інтервал має бути ≥ 1 хвилини
`Order is already completed`	Не можна скасувати завершене замовлення
`Refill is not available for this order`	Послуга не підтримує refill або замовлення не завершено

API Documentation