REST API · Версия 1

Справочник API

Автоматизируйте заказы, пополнения и проверки статуса, обращаясь к Best SMM Panel | Real Services - SureSMM напрямую. Каждый запрос — это всего один POST с вашим API-ключом — ответы возвращаются в виде чистого JSON.

POST https://suresmm.com/api/v1
Ответ JSON Аутентификация по ключу 120 запр/мин
Начало работы

Аутентификация

Каждый запрос аутентифицируется с помощью вашего личного API-ключа. Получите его в личном кабинете в разделе «Аккаунт → API» и передавайте его как key параметр в каждом запросе.

Параметр Тип Описание Обязательно
key string Ваш уникальный API-ключ Обязательно
action string Действие эндпоинта — например, services, add, status, refill, balance Обязательно
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
GET /services

Список услуг

Возвращает полный каталог услуг с актуальными тарифами, лимитами и поддержкой рефилла/дрип-фида.

Параметр Тип Описание
key string Ваш API-ключ
action string "services"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=services"
200 Ответ
[
  {
    "service": 1,
    "name": "YouTube Livestream Viewers",
    "rate": "0.33000000",
    "min": 1000,
    "max": 200000,
    "category": "Live Stream",
    "refill": true,
    "dripfeed": true
  }
]
POST /add

Добавить заказ

Оформите новый заказ на услугу. Необязательные поля дрип-фида позволяют разбить доставку на несколько подходов.

Параметр Тип Описание Обязательно
key string Ваш API-ключ Обязательно
action string "add" Обязательно
service integer ID услуги Обязательно
link string Ссылка на страницу Обязательно
quantity integer Количество к выполнению Обязательно
runs integer Количество подходов Необязательно
interval integer Интервал в минутах Необязательно
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=add" \
  -d "service=1" \
  -d "link=https://example.com/post" \
  -d "quantity=1000"
200 Ответ
{
  "order": 1242
}
POST /status

Статус заказа

Проверяйте прогресс любого заказа — статус, начальное количество и оставшееся количество.

Параметр Тип Описание
key string Ваш API-ключ
action string "status"
order integer ID заказа
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=status" \
  -d "order=1242"
200 Ответ
{
  "status": "Pending",
  "start_count": "1000",
  "remains": "500",
  "currency": "USD"
}
Доступные статусы
В ожидании В обработке Выполнено Частично Отменено Возвращено
POST /refill

Рефилл

Запросите рефилл для подходящего заказа, а затем отслеживайте его статус до завершения.

Создать рефилл

Параметр Тип Описание
key string Ваш API-ключ
action string "refill"
order integer ID заказа
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill" \
  -d "order=1242"
200 Ответ
{
  "success": "Your order will be refilled asap. Thank you for your patience",
  "refill": 12345
}

Статус рефилла

Параметр Тип Описание
key string Ваш API-ключ
action string "refill_status"
refill integer ID рефилла
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=refill_status" \
  -d "refill=12345"
200 Ответ
{
  "status": "Completed"
}
POST /balance

Баланс пользователя

Получите текущий баланс аккаунта и его валюту.

Параметр Тип Описание
key string Ваш API-ключ
action string "balance"
cURL
curl -X POST https://suresmm.com/api/v1 \
  -d "key=YOUR_API_KEY" \
  -d "action=balance"
200 Ответ
{
  "balance": "100.84292",
  "currency": "USD"
}
Справочник

Ответы с ошибками

Если запрос некорректен, API возвращает объект JSON, содержащий error с сообщением об ошибке. Наиболее распространённые из них перечислены ниже.

Поле action обязательно
Поле api key обязательно
Неверный api key
Неверное действие
Неверный ID услуги
Поле ссылки обязательно для заполнения
Поле количества обязательно для заполнения
Пожалуйста, соблюдайте лимит
Недостаточно средств
Поле заказа обязательно для заполнения
Неверный ID заказа
Заказ не подлежит восполнению
Структура ошибки
{
  "error": "Invalid api key"
}
Написать нам в чат