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?