SMM панель API: документация

Что такое API SMM панели?

API SMM панели позволяет программе получать список услуг, создавать заказы и проверять статус заказов и баланс без захода на сайт. 4SNS PLUS поддерживает стандартный формат API v2, который используют многие панели и боты, поэтому код, уже подключенный к другой панели, заработает сразу после замены URL и ключа.

Цены и баланс в API такие же, как на сайте. rate в ответе services равен цене за 1,000 (в долларах США) из прайса, а заказы через add списываются с баланса точно так же, как заказы на сайте, и тоже видны в истории заказов в личном кабинете. Суммы по отмененным и частичным заказам возвращаются на тот же баланс.

Основное

Пример запроса

curl -X POST https://4snsplus.com/api/v2 \
  -d key=YOUR_API_KEY \
  -d action=balance

import requests

r = requests.post("https://4snsplus.com/api/v2", data={
    "key": "YOUR_API_KEY",
    "action": "add",
    "service": 2210,
    "link": "https://t.me/yourchannel",
    "quantity": 1000,
})
print(r.json())  # {"order": 31877} or {"error": "..."}

Как получить API ключ?

Как только первое пополнение зачислено на баланс, вы можете создать API ключ в разделе API ключ личного кабинета. Ключ показывается только один раз при создании, поэтому сохраните его в надежном месте. При создании нового ключа предыдущий сразу отключается.

Ключ отделен от токена аккаунта. В бот или на сервер добавляйте только API ключ, а токен аккаунта не указывайте нигде. Если вам кажется, что ключ стал известен другим, просто создайте новый на экране API ключа.

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

Возвращает все услуги, доступные для заказа. rate это цена за 1,000 (USD), а при type Package это цена одного пакета. При type Custom Comments вместо количества вы отправляете список комментариев. category состоит из названия платформы и названия группы.

Пример ответа

[
  {
    "service": 2210,
    "name": "Members - 30 Days Non Drop - 30 Days Refill",
    "type": "Default",
    "category": "Telegram - Members (30 Days Non Drop)",
    "rate": "1.4300",
    "min": "100",
    "max": "50000",
    "refill": true,
    "cancel": false
  }
]

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

Создает заказ и списывает сумму с баланса. Сумма равна цене за 1,000, умноженной на количество; для Package это цена пакета, а для Custom Comments количеством считается число строк комментариев. Заказы доступны аккаунтам, у которых зачислено первое пополнение. order в ответе это ID вашего заказа.

Пример ответа

{
  "order": 31877
}

Статус заказа (status)

Статус одного заказа. charge это фактически оплаченная сумма после возвратов (USD, 6 знаков после запятой), start_count это значение счетчика на старте заказа, remains это количество, которое еще не выполнено.

Пример ответа

{
  "charge": "1.430000",
  "start_count": "8120",
  "status": "In progress",
  "remains": "410",
  "currency": "USD"
}

Статус нескольких заказов (status, orders)

Проверяет до 100 заказов за раз, ID заказов перечисляются через запятую. Для ID, которых нет или которые не относятся к вашему аккаунту, на их месте возвращается ошибка.

Пример ответа

{
  "1": { "charge": "0.300000", "start_count": "120", "status": "Completed", "remains": "0", "currency": "USD" },
  "10": { "error": "Incorrect order ID" }
}

Запрос докрутки (refill)

Для заказа услуги с периодом докрутки, который завершился со статусом Completed или Partial, отправьте запрос в течение периода докрутки, считая с момента завершения. На каждый заказ может быть один открытый запрос, с интервалом 24 часа между запросами.

Пример ответа

{
  "refill": 512
}

Статус докрутки (refill_status)

Статус одного запроса на докрутку.

Пример ответа

{
  "status": "Completed"
}

Баланс (balance)

Ваш баланс (USD, 6 знаков после запятой).

Пример ответа

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

Значения статуса заказа

Значения статуса докрутки

Сообщения об ошибках

Ошибки приходят в JSON с полем error в ответе HTTP 200. В коде сначала проверяйте наличие поля error.

{
  "error": "Not enough funds on balance"
}

Как подключить API SMM панели к боту Telegram?