Документація для розробників

API smmto.com

Інтегруйте наші послуги у свою платформу через потужний REST API. Швидко, надійно й просто. Створіть свій інструмент зростання або панель реселера вже сьогодні.

Аптайм 99.9%
Час відповіді <200ms
Обсяг 50M+
Отримати API-ключ Переглянути на GitHub

1. Початок роботи

Наш API побудовано на принципах REST. Використовуються стандартні HTTP-коди відповіді, автентифікація та методи. Усі запити надсилаються на базовий URL і повертають відповіді у форматі JSON.

Базовий URL: https://smmto.com/api/v2

2. Автентифікація

Для автентифікації запитів вказуйте унікальний API-ключ як параметр `key` у кожному запиті. Ключ можна знайти в панелі акаунта.

POST https://smmto.com/api/v2
Content-Type: application/json

{
  "key": "your-api-key-here",
  "action": "services"
}

Зберігайте API-ключ у секреті. Не публікуйте його у відкритих репозиторіях, клієнтському коді чи документації. У разі компрометації негайно перевидайте ключ.

3. Додати замовлення

POST /api/v2

Оформіть нове замовлення на будь-яку послугу соцмереж, доступну на нашій платформі.

Параметр Тип Обов'язково Опис
keystringYesYour unique API key
actionstringYes"add"
serviceintegerYesService ID (from Services List)
linkstringYesTarget URL (e.g. Channel link)
quantityintegerYesTotal quantity to deliver

Приклад запиту

{
  "key": "your-api-key",
  "action": "add",
  "service": 1,
  "link": "https://t.me/yourchannel",
  "quantity": 1000
}

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

{
  "order": 23501,
  "status": "success"
}

4. Статус замовлення

POST /api/v2

Перевірте статус і прогрес раніше оформленого замовлення.

Параметр Тип Обов'язково Опис
keystringYesYour API key
actionstringYes"status"
orderintegerYesThe ID of the order
 
{
  "charge": "0.5000",
  "start_count": "1200",
  "status": "In Progress",
  "remains": "450",
  "currency": "USD"
}

5. Кілька замовлень

POST /api/v2

Ефективність важлива. Використовуйте bulk-ендпоінт, щоб оформити до 100 замовлень одним API-викликом.

{
  "key": "your-api-key",
  "action": "add_bulk",
  "orders": [
    { "service": 1, "link": "link_1", "quantity": 100 },
    { "service": 2, "link": "link_2", "quantity": 250 }
  ]
}

6. Cancel Order

POST /api/v2

Cancel a pending or in-progress order by order ID.

{
  "key": "your-api-key",
  "action": "cancel",
  "order": 23501
}

7. Refill Order

POST /api/v2

Request a refill for eligible orders that dropped below the guaranteed level.

{
  "key": "your-api-key",
  "action": "refill",
  "order": 23501
}

8. Services List

POST /api/v2

Retrieve the full list of available services, rates, min/max quantities, and metadata.

{
  "key": "your-api-key",
  "action": "services"
}

9. Коди помилок

API використовує стандартні HTTP-коди статусу для позначення успіху або помилки.

Код Повідомлення Опис
400Invalid requestMissing or invalid parameters
401Invalid API keyAuthentication failed
404Service not foundInvalid service ID
429Rate limit exceededToo many requests
500Internal errorServer-side error

10. Rate Limits

API requests are limited to 100 requests per minute per API key. Exceeding this limit returns HTTP 429. Contact support for higher throughput on reseller plans.

11. SDK і бібліотеки

12. Changelog

v2.0 — Unified REST endpoint at /api/v2 with bulk orders, refill status, and improved error responses.

Методи Panel API

Service list

POST /api/v2 services
Параметр Опис
key Your API key
action services

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

[
    {
        "service": 1,
        "name": "Followers",
        "type": "Default",
        "category": "First Category",
        "rate": "0.90",
        "min": "50",
        "max": "10000",
        "refill": true,
        "cancel": true
    },
    {
        "service": 2,
        "name": "Comments",
        "type": "Custom Comments",
        "category": "Second Category",
        "rate": "8",
        "min": "10",
        "max": "1500",
        "refill": false,
        "cancel": true
    }
]

Add order

POST /api/v2 add

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

{
    "order": 23501
}

Order status

POST /api/v2 status
Параметр Опис
key Your API key
action status
order Order ID

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

{
    "charge": "0.27819",
    "start_count": "3572",
    "status": "Partial",
    "remains": "157",
    "currency": "USD"
}

Multiple orders status

POST /api/v2 multi_status
Параметр Опис
key Your API key
action status
orders Order IDs (separated by a comma, up to 100 IDs)

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

{
    "1": {
        "charge": "0.27819",
        "start_count": "3572",
        "status": "Partial",
        "remains": "157",
        "currency": "USD"
    },
    "10": {
        "error": "Incorrect order ID"
    },
    "100": {
        "charge": "1.44219",
        "start_count": "234",
        "status": "In progress",
        "remains": "10",
        "currency": "USD"
    }
}

Create refill

POST /api/v2 refill
Параметр Опис
key Your API key
action refill
order Order ID

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

{
    "refill": "1"
}

Create multiple refill

POST /api/v2 multi_refill
Параметр Опис
key Your API key
action refill
orders Order IDs (separated by a comma, up to 100 IDs)

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

[
    {
        "order": 1,
        "refill": 1
    },
    {
        "order": 2,
        "refill": 2
    },
    {
        "order": 3,
        "refill": {
            "error": "Incorrect order ID"
        }
    }
]

Get refill status

POST /api/v2 refill_status
Параметр Опис
key Your API key
action refill_status
refill Refill ID

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

{
    "status": "Completed"
}

Get multiple refill status

POST /api/v2 multi_refill_status
Параметр Опис
key Your API key
action refill_status
refills Refill IDs (separated by a comma, up to 100 IDs)

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

[
    {
        "refill": 1,
        "status": "Completed"
    },
    {
        "refill": 2,
        "status": "Rejected"
    },
    {
        "refill": 3,
        "status": {
            "error": "Refill not found"
        }
    }
]

Create cancel

POST /api/v2 cancel
Параметр Опис
key Your API key
action cancel
orders Order IDs (separated by a comma, up to 100 IDs)

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

[
    {
        "order": 9,
        "cancel": {
            "error": "Incorrect order ID"
        }
    },
    {
        "order": 2,
        "cancel": 1
    }
]

User balance

POST /api/v2 balance
Параметр Опис
key Your API key
action balance

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

{
    "balance": "100.84292",
    "currency": "USD"
}
Приклад коду PHP
Онлайн-чат Підтримка 24/7