Реселлер в SMM продаёт услуги под своим брендом, а исполнение отдаёт панели-поставщику. Чтобы не переносить заказы вручную, сайт или бот реселлера подключают к поставщику по API. Разберём, как устроен API SMMPanel.ru, какие запросы нужны для своей панели и как выстроить наценку, чтобы цены не расходились с закупкой.

Как устроен API

API SMMPanel.ru построен по схеме, привычной для SMM-панелей: один адрес, один метод HTTP, а действие задаётся параметром action.

На странице документации есть готовые примеры кода на PHP. Если ваша панель написана на PHP, это быстрый старт. Для других языков схема та же: обычный POST-запрос с полями формы.

Ключ выдаётся в личном кабинете. Если на запрос приходит ответ «API отключён для этого пользователя», напишите в поддержку через тикет: доступ к API включается для аккаунта отдельно. По FAQ сервиса, для реселлеров возможны персональные цены — это тоже вопрос к поддержке.

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

Пять запросов, на которых держится панель

Действие action Ключевые параметры Что возвращает
Список услуг services key Массив услуг: service, name, category, rate, min, max, type, dripfeed
Новый заказ add service, link, quantity Номер заказа order
Статус заказа status order status, charge, start_count, remains
Статусы пачкой status orders — номера через запятую Объект, где ключ — номер заказа
Баланс balance key balance и currency

Список услуг

Запрос services — основа каталога. Поле rate — цена за 1000 единиц, min и max — допустимый объём одного заказа. Поле type определяет, какие параметры нужны при создании заказа. Флаг dripfeed показывает, поддерживает ли услуга постепенную доставку.

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

У стандартной услуги (type — Default) три обязательных поля: service, link и quantity. Если услуга поддерживает постепенную доставку, добавьте:

Для услуг с типом Custom Comments вместо quantity передают comments — список комментариев, каждый с новой строки.

Статусы

Запрос status возвращает текущий статус, списанную сумму charge, стартовое значение счётчика start_count и остаток remains. Опрашивать заказы по одному неэффективно. Передавайте номера активных заказов в orders через запятую одним запросом. Неверный номер вернётся строкой с ошибкой, остальные — объектами, поэтому обрабатывайте оба варианта.

Каталог реселлера — это копия каталога поставщика с вашими ценами. Как только копия устаревает, вы продаёте то, чего уже нет, или по цене ниже закупки.

Схема наценки

Наценку удобно считать от поля rate, а не держать цены вручную. Базовая формула:

Несколько практических правил:

  1. Наценка по категориям, а не одна на всё. Дешёвые массовые услуги и дорогие штучные (например, бусты) требуют разной логики. Задайте процент на категорию и минимальную цену заказа.
  2. Округление вверх. Цены за 1000 часто имеют четыре знака после запятой. Округляйте клиентскую цену вверх до удобного шага, чтобы не уйти в минус на копейках.
  3. Синхронизация по расписанию. Обновляйте services регулярно, например раз в час. Если rate вырос, пересчитайте цену. Если услуга пропала из ответа — скройте её у себя.
  4. Лимиты как у поставщика. Не позволяйте клиенту заказать меньше min или больше max, иначе заказ не пройдёт.
  5. Возвраты — пропорционально. Если заказ выполнен частично, поставщик возвращает деньги за невыполненный объём на ваш баланс. Верните клиенту его долю: остаток remains × ваша цена за 1000 / 1000.

Запуск за один вечер: порядок действий

  1. Зарегистрируйтесь на smmpanel.ru и пополните баланс.
  2. Получите API-ключ в кабинете. Проверьте его запросом balance.
  3. Выгрузите services и сохраните в базу: ID услуги поставщика, название, категория, rate, лимиты, type.
  4. Отберите услуги для витрины. Не обязательно продавать весь каталог — начните с нескольких категорий, которые знаете.
  5. Задайте наценки по категориям и пересчитайте цены.
  6. Настройте создание заказа: клиент платит вам, ваша панель отправляет add и сохраняет номер order.
  7. Поставьте фоновую задачу, которая раз в несколько минут опрашивает активные заказы пачкой и обновляет статусы у клиентов.
  8. Добавьте контроль баланса. Если balance ниже порога, панель должна предупредить вас до того, как заказы начнут отклоняться.

Что показать клиенту

Клиенту не нужны технические поля, но кое-что из ответа полезно вывести:

Частые ошибки реселлеров

Если панель нужна не на сайте, а прямо в Telegram, посмотрите, как устроен бот @SmmPanelRUbot: его логика — каталог, заказ, статусы, поддержка — хороший ориентир для собственного бота.

Что попробовать