API Docs

Документация API

В проекте доступны два API-режима: REST API v2 для новых интеграций и Compat API для SMM-ботов, которые работают через action=....

OpenAPI и 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>.

Получение токена

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
  }'

Создание заказа

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
  }'

2. Compat API (SMM формат)

Базовый 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 - отмена заказа

Проверка баланса

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

Создание заказа

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

Статус / 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"

Важно

Для Compat API используйте API-токен пользователя (из кабинета), а не ключ провайдера.
В status/refill/cancel передавайте локальный ID заказа, который вернул метод add.
REST API v2 возвращает формат success + data/error + meta, Compat API возвращает SMM-совместимый JSON.