Перейти до вмісту
УвійтиРеєстрація

API SMM-панелі: послуги, замовлення, статус і баланс

API SMMHO використовує формат API v2, поширений серед SMM-панелей. Надішліть POST-запит на одну адресу, оберіть дію значенням action і отримайте відповідь у JSON.

Основи API

Адреса
POST https://smmho.com/api/v2
Формат запиту
application/x-www-form-urlencoded або application/json
Автентифікація
Ваш API-ключ у полі key. Створіть його на сторінці акаунта після входу
Відповідь
JSON. У разі помилки причина повертається в полі error
Ліміт запитів
300 запитів на хвилину на ключ
Створити API-ключСтворіть свій API-ключ на сторінці акаунта після входу.
curl https://smmho.com/api/v2 \  -d "key=YOUR_API_KEY" \  -d "action=add" -d "service=9340" \  -d "link=https://instagram.com/me" \  -d "quantity=1000"
// { "order": "TT5M-CA9L" }

Дії API SMM-панелі

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

Повертає всі послуги з ID, назвою, категорією, ціною за 1 000, мінімальною й максимальною кількістю та ознакою відновлення.

Параметри
НазваОпис
keyAPI-ключ
actionservices

Приклад відповіді

[
  {
    "service": 9340,
    "name": "Instagram Followers, 30-day refill",
    "type": "Default",
    "category": "Instagram Followers",
    "rate": "2.2470",
    "min": 50,
    "max": 75000,
    "refill": true,
    "cancel": true
  }
]

action=addНове замовлення

Оформлює замовлення за ID послуги, посиланням і кількістю. Вартість списується з балансу, повертається код замовлення.

Параметри
НазваОпис
keyAPI-ключ
actionadd
serviceID послуги
linkПосилання на акаунт або публікацію
quantityКількість (у межах мінімуму й максимуму послуги)

Приклад відповіді

{
  "order": "TT5M-CA9L"
}

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

Повертає вартість, початкову кількість, статус і залишок для одного коду замовлення (order) або до 100 кодів через кому (orders).

Параметри
НазваОпис
keyAPI-ключ
actionstatus
orderОдин код замовлення
ordersКілька кодів замовлень (через кому, до 100)

Приклад відповіді

{
  "charge": "2.2470",
  "start_count": 0,
  "status": "Pending",
  "remains": 1000,
  "currency": "USD"
}

action=balanceБаланс

Повертає поточний баланс і валюту.

Параметри
НазваОпис
keyAPI-ключ
actionbalance

Приклад відповіді

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

action=cancelСкасування замовлень

Скасовує замовлення в очікуванні. Вартість повертається на баланс.

Параметри
НазваОпис
keyAPI-ключ
actioncancel
ordersКоди замовлень (через кому, до 100)

Приклад відповіді

[
  {
    "order": "TT5M-CA9L",
    "cancel": 1
  }
]

action=refillЗапит на відновлення

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

Параметри
НазваОпис
keyAPI-ключ
actionrefill
orderКод замовлення

Приклад відповіді

{
  "refill": "RK7QM-2XWD"
}

Значення статусів замовлення

Pending
Ще не почато, можна скасувати
In progress
Виконується доставка
Completed
Доставлено повністю
Partial
Доставлено частково. Недоставлена частина повертається на баланс
Canceled
Скасовано. Вартість повертається на баланс

Помилки API

Invalid API key
Ключ неправильний або замінений новим
Invalid service
Послуги з таким ID немає
Invalid link
Це не відкрита адреса, що починається з https://
Quantity out of range
Кількість виходить за межі мінімуму й максимуму послуги
Not enough funds on balance
На вашому балансі недостатньо коштів
Too many requests
Досягнуто ліміт запитів. Надішліть ще раз трохи згодом
Refill already requested
Запит на відновлення для цього замовлення вже відкритий
Refill is not available for this order
У послуги немає відновлення або період відновлення закінчився