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

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