API Documentation — Palladium SMM

Аутентификация

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

POST запрос

                                
POST /api/v2
Content-Type: application/x-www-form-urlencoded

key=YOUR_API_KEY&action=balance

GET запрос

GET /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.50",
    "min": 100,
    "max": 10000,
    "refill": true,
    "cancel": false,
    "category": "Instagram",
    "description": ""
  }
]

rate — цена за 1000 единиц в USD.

add Создать заказ

action=add Создаёт новый заказ, списывает средства с баланса

Параметры

Параметр	Тип	Описание
`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 /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`	Ключ не найден или неверный
`Incorrect action`	Неизвестное значение `action`
`Incorrect parameters`	Не передан `service` или `link`
`Incorrect service ID`	Услуга не найдена или отключена
`Incorrect order ID`	Заказ не найден или чужой
`Not enough funds on balance`	Недостаточно средств
`Quantity must be between X and Y`	Количество вне диапазона
`Order is already completed`	Нельзя отменить завершённый заказ
`Refill is not available for this order`	Услуга не поддерживает refill или заказ не завершён