Документация 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)	опционально
`runs`	integer	Количество запусков — runs и interval вместе включают 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 Inqueue Moderation 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