API Docs

Documentation by API

There are two API modes available: REST API v2 for new integrations and Compat API для SMM-ботов, которые работают через action=....

OpenAPI and Swagger

openapi-v2.json openapi-compat.json Swagger v2 Swagger Compat

1. REST API v2 (Bearer)

Базовый URL: https://smmflash.ru/api/v2.
Приватные методы используют заголовок Authorization: Bearer <TOKEN>.

Receiving a token

curl -X POST "https://smmflash.ru/api/v2/auth/token" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "you@example.com",
    "password": "your_password",
    "token_name": "Server integration",
    "ttl_days": 30
  }'

Ordering

curl -X POST "https://smmflash.ru/api/v2/orders" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "service_id": 9,
    "link": "https://t.me/your_channel/123",
    "quantity": 1000
  }'

Compat API (SMM format)

Базовый URL: https://smmflash.ru/api (также доступен https://smmflash.ru/api/v2).
Формат запроса: POST key=...&action=....

action=balance - баланс аккаунта
action=services - список услуг
action=add - создать заказ
action=status - статус заказа
action=refill - запрос refill
action=cancel - отмена заказа

Balance check

curl -X POST "https://smmflash.ru/api" \
  -d "key=YOUR_TOKEN&action=balance"

Ordering

curl -X POST "https://smmflash.ru/api" \
  -d "key=YOUR_TOKEN&action=add&service=9&link=https://t.me/your_channel/123&quantity=1000"

Status / refill / cancel

# status
curl -X POST "https://smmflash.ru/api" -d "key=YOUR_TOKEN&action=status&order=123"

# refill
curl -X POST "https://smmflash.ru/api" -d "key=YOUR_TOKEN&action=refill&order=123"

# cancel
curl -X POST "https://smmflash.ru/api" -d "key=YOUR_TOKEN&action=cancel&order=123"

It's important

For Compat API, use the user's API token (from the cabinet) rather than the provider's key.
В status/refill/cancel передавайте локальный ID заказа, который вернул метод add.
REST API v2 возвращает формат success + data/error + meta, Compat API возвращает SMM-совместимый JSON.