Реселлер в SMM продаёт услуги под своим брендом, а исполнение отдаёт панели-поставщику. Чтобы не переносить заказы вручную, сайт или бот реселлера подключают к поставщику по API. Разберём, как устроен API SMMPanel.ru, какие запросы нужны для своей панели и как выстроить наценку, чтобы цены не расходились с закупкой.
Как устроен API
API SMMPanel.ru построен по схеме, привычной для SMM-панелей: один адрес, один метод HTTP, а действие задаётся параметром action.
- Метод: POST.
- Формат ответа: JSON.
- Адрес: указан в документации API — берите его оттуда, а не из старых примеров.
- Авторизация: параметр
keyс вашим API-ключом в каждом запросе. - Валюта: баланс и цены — в долларах США.
На странице документации есть готовые примеры кода на PHP. Если ваша панель написана на PHP, это быстрый старт. Для других языков схема та же: обычный POST-запрос с полями формы.
Ключ выдаётся в личном кабинете. Если на запрос приходит ответ «API отключён для этого пользователя», напишите в поддержку через тикет: доступ к API включается для аккаунта отдельно. По FAQ сервиса, для реселлеров возможны персональные цены — это тоже вопрос к поддержке.
Пять запросов, на которых держится панель
| Действие | 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. Если услуга поддерживает постепенную доставку, добавьте:
runs— на сколько частей разбить заказ;interval— пауза между частями в минутах.
Для услуг с типом Custom Comments вместо quantity передают comments — список комментариев, каждый с новой строки.
Статусы
Запрос status возвращает текущий статус, списанную сумму charge, стартовое значение счётчика start_count и остаток remains. Опрашивать заказы по одному неэффективно. Передавайте номера активных заказов в orders через запятую одним запросом. Неверный номер вернётся строкой с ошибкой, остальные — объектами, поэтому обрабатывайте оба варианта.
Каталог реселлера — это копия каталога поставщика с вашими ценами. Как только копия устаревает, вы продаёте то, чего уже нет, или по цене ниже закупки.
Схема наценки
Наценку удобно считать от поля rate, а не держать цены вручную. Базовая формула:
- Цена для клиента за 1000 =
rate× (1 + наценка); - Стоимость заказа для клиента = цена за 1000 ×
quantity/ 1000; - Закупка по заказу — поле
chargeиз ответаstatus. Сверяйте её с тем, что списали с клиента.
Несколько практических правил:
- Наценка по категориям, а не одна на всё. Дешёвые массовые услуги и дорогие штучные (например, бусты) требуют разной логики. Задайте процент на категорию и минимальную цену заказа.
- Округление вверх. Цены за 1000 часто имеют четыре знака после запятой. Округляйте клиентскую цену вверх до удобного шага, чтобы не уйти в минус на копейках.
- Синхронизация по расписанию. Обновляйте
servicesрегулярно, например раз в час. Еслиrateвырос, пересчитайте цену. Если услуга пропала из ответа — скройте её у себя. - Лимиты как у поставщика. Не позволяйте клиенту заказать меньше
minили большеmax, иначе заказ не пройдёт. - Возвраты — пропорционально. Если заказ выполнен частично, поставщик возвращает деньги за невыполненный объём на ваш баланс. Верните клиенту его долю: остаток
remains× ваша цена за 1000 / 1000.
Запуск за один вечер: порядок действий
- Зарегистрируйтесь на smmpanel.ru и пополните баланс.
- Получите API-ключ в кабинете. Проверьте его запросом
balance. - Выгрузите
servicesи сохраните в базу: ID услуги поставщика, название, категория,rate, лимиты,type. - Отберите услуги для витрины. Не обязательно продавать весь каталог — начните с нескольких категорий, которые знаете.
- Задайте наценки по категориям и пересчитайте цены.
- Настройте создание заказа: клиент платит вам, ваша панель отправляет
addи сохраняет номерorder. - Поставьте фоновую задачу, которая раз в несколько минут опрашивает активные заказы пачкой и обновляет статусы у клиентов.
- Добавьте контроль баланса. Если
balanceниже порога, панель должна предупредить вас до того, как заказы начнут отклоняться.
Что показать клиенту
Клиенту не нужны технические поля, но кое-что из ответа полезно вывести:
- статус заказа простыми словами: «в очереди», «выполняется», «выполнен», «частично», «отменён»;
- остаток — сколько единиц ещё в работе;
- сумму возврата, если заказ выполнен частично.
Частые ошибки реселлеров
- Ручной каталог. Цены переписаны один раз и не обновляются. Через месяц часть услуг продаётся в убыток.
- Нет проверки ссылки. Клиент присылает ссылку на пост вместо профиля или наоборот. Проверяйте формат ссылки до отправки заказа.
- Опрос статусов по одному. Это медленно и создаёт лишнюю нагрузку. Используйте пакетный запрос.
- Нет обработки частичных заказов. Клиент видит «выполнено», хотя часть объёма вернулась деньгами. Это порождает тикеты и недоверие.
- Обещания, которых нет у поставщика. Срок гарантии и восстановления у каждой услуги свой и указан в её описании. Не обещайте клиенту больше.
Если панель нужна не на сайте, а прямо в Telegram, посмотрите, как устроен бот @SmmPanelRUbot: его логика — каталог, заказ, статусы, поддержка — хороший ориентир для собственного бота.
Что попробовать
- Прочитайте документацию API и скачайте примеры кода.
- Сверьте цены и лимиты в прайс-листе с ответом
services. - Посмотрите правила гарантии и возвратов в условиях сервиса, прежде чем писать свои.