Как связать услуги поставщика с карточками SMM-панели через API
Зачем отделять каталог поставщика от витрины панели
API поставщика обычно возвращает технический каталог: внешний ID, название, цену, лимиты, статус и параметры заказа. В SMM-панели та же позиция должна попадать в понятную клиенту структуру: площадка, тип продвижения, география, формат ссылки, качество аудитории или скорость запуска.
Если вывести внешний каталог без обработки, в витрине появятся технические названия, дубли и недоступные позиции. Сопоставление разделяет закупочную логику и клиентскую карточку. Одна услуга поставщика не обязана быть отдельной услугой в панели.
Какие данные нужно получать через API
Сохраняйте исходные данные поставщика отдельно от настроек витрины. Внешний ID нельзя заменять внутренним идентификатором панели: он нужен для создания заказа, получения статуса, отмены и разбора ошибок. Полезно также хранить время последней синхронизации и полный ответ API либо его снимок.
- Идентификатор поставщика и внешний ID услуги.
- Название, описание и внешнюю категорию.
- Закупочную цену, валюту и единицу расчёта.
- Минимальный, максимальный объём и шаг количества.
- Статус доступности, остаток и признак временной остановки.
- Требования к ссылке, логину, публикации, комментарию и географии.
- Признаки ручного запуска, отмены, дозапуска и частичного выполнения.
Недостаток автоматического импорта в том, что поставщики по-разному называют одинаковые поля и иногда передают неполные данные. Название услуги не подходит для устойчивой связи: его могут изменить без смены внешнего ID.
Пример запроса и ответа каталога услуг
Формат API зависит от поставщика, но логика обычно одинакова: панель передаёт ключ доступа и параметры страницы, а в ответ получает массив услуг. Например, запрос каталога с курсором может выглядеть так:
GET /api/services?cursor=eyJwYWdlIjoyfQ
Условный ответ API:
{ "services": [ { "id": "SP-1042", "name": "Global Followers", "platform": "twitch", "type": "followers", "price": "12.50", "min": 100, "max": 10000, "status": "active" } ], "next_cursor": "eyJwYWdlIjozfQ" }
Поля ответа не стоит сразу записывать в карточку витрины. Сначала их нужно проверить, сохранить в каталоге поставщика и сопоставить с внутренними правилами. Недостаток работы только с готовой карточкой — импорт может перезаписать клиентское название, описание или вручную выбранную категорию.
Сначала задайте структуру категорий в панели
До импорта определите таксономию панели. Верхний уровень обычно описывает площадку, следующий — действие: подписчики, просмотры, реакции, комментарии, зрители трансляции или другой формат. Внутри можно разделить услуги по географии, типу аудитории, скорости и условиям компенсации.
Для каждой категории задайте обязательные признаки. У просмотров это может быть тип ссылки и формат контента, у подписчиков — площадка, география и допустимый тип профиля. Недостаток слишком детальной структуры — каталог становится сложнее поддерживать, а близкие услуги начинают отличаться только внутренними нюансами.
Храните связи поставщика и витрины отдельно
Связка между услугой поставщика и карточкой панели должна храниться в отдельной таблице или сущности. В ней нужны поставщик, внешний ID, внутренняя карточка, категория, правило цены, приоритет маршрута, статус публикации и дата последней успешной проверки.
Такая схема позволяет заменить поставщика без смены URL карточки и без потери истории заказов. Пример строки маппинга в JSON:
{ "supplier_id": "supplier_a", "external_service_id": "SP-1042", "panel_category": "twitch_followers", "showcase_card_id": "followers_global", "route_priority": 1, "status": "active" }

Связи могут быть разными, но для каждой заранее определите правило обновления.
- Одна услуга поставщика — одна карточка, если у неё уникальные параметры и форма заказа.
- Несколько услуг разных поставщиков — одна карточка, если они совместимы по требованиям и условиям.
- Одна услуга поставщика — несколько карточек, если витрина разделяет её по языку, сегменту или способу продажи.
У объединения нескольких поставщиков в одной карточке есть недостаток: скорость, доступность и фактические условия выполнения могут различаться. Не объединяйте маршруты с разными форматами ссылки, лимитами или обязательными полями.
Импортируйте каталог постранично
Поставщик может отдавать каталог страницами через номер, смещение или курсор. Первый ответ не обязательно содержит все услуги. Запрашивайте следующую страницу, пока API передаёт курсор, ссылку на продолжение или другой явный признак наличия данных.
При курсорной пагинации обработка выглядит так: панель получает страницу, сохраняет все услуги, фиксирует их как найденные в текущем цикле и только затем переходит к следующему курсору. Если поле next_cursor отсутствует, обход считается завершённым.
- Создайте идентификатор текущего цикла синхронизации.
- Запросите первую страницу и сохраните полученные услуги.
- Для каждой услуги обновите поле last_seen_sync идентификатором цикла.
- Сохраните курсор следующей страницы до выполнения следующего запроса.
- После успешного обхода всех страниц сравните каталог с текущим циклом.
Недостаток последовательной загрузки страниц — полный импорт может идти дольше. Параллельные запросы ускоряют процесс, но повышают риск упереться в ограничение API или получить страницы в разном состоянии каталога.
Не создавайте дубли при повторной синхронизации
Для поиска существующей услуги используйте составной ключ: идентификатор поставщика и внешний ID услуги. При каждом повторном импорте сначала ищите запись по этой паре, затем обновляйте технические поля. Новую запись создавайте только при отсутствии такого ключа.
Не используйте для дедупликации название, цену или категорию. У двух разных услуг могут совпадать эти значения, а поставщик может переименовать позицию без изменения внешнего ID. Для связей с витриной также нужен уникальный контроль: один и тот же маршрут не должен появляться дважды после повторного запуска задачи.
Полезно ограничить уникальность на уровне базы данных: supplier_id + external_service_id для каталога поставщика и supplier_id + external_service_id + showcase_card_id для маппинга. Недостаток жёсткого ограничения — при ошибке в старой связи её придётся исправлять явно, а не создавать новую запись поверх неё.
Как находить удалённые и пропавшие услуги
Услугу можно считать пропавшей только после полностью успешного обхода всех страниц. Если синхронизация остановилась на ошибке, лимите запросов или недоступности API, отсутствующие в уже загруженной части каталога позиции нельзя помечать удалёнными.
После завершённого импорта найдите услуги этого поставщика, у которых last_seen_sync не равен идентификатору текущего цикла. Им присваивают статус «не найдена» или «архивирована», отключают от новых заказов и отправляют на проверку. Внешний ID, историю изменений и связи с заказами сохраняют.
Исчезнувшую услугу нужно архивировать, а не удалять. Поставщик может вернуть её в каталог позже, изменить фильтр ответа или временно скрыть позицию. Архивную связь можно восстановить при следующем импорте, если тот же внешний ID снова появился.
Что делать при смене внешнего ID услуги
Если поставщик создал новую услугу вместо старой, новый внешний ID нельзя автоматически считать продолжением прежнего. Даже при одинаковом названии и цене у позиции могут измениться требования к заказу, география, тип аудитории или условия компенсации.
Старую связь переведите в архив, снимите маршрут с продажи и сохраните её для старых заказов. Новую услугу импортируйте как отдельную запись. Затем создайте новый маппинг вручную или по безопасному правилу, если технические параметры полностью совместимы.
Автоматическое сопоставление по названию может ускорить работу, но его недостаток — риск отправить заказ на другую услугу с неподходящими условиями. Для смены ID лучше использовать статус «требует проверки», а не тихую замену маршрута.
Настройте маппинг по стабильным техническим полям
Автоматическое распределение услуг лучше строить по набору полей: площадка, тип услуги, география, формат ссылки, минимальный объём, дополнительные параметры и статус. Например, услуга может попасть в категорию просмотров по гео, если API передаёт совместимые значения платформы, типа продвижения и страны.
Если поставщик требует комментарий, список профилей или ручной запуск, не публикуйте маршрут в стандартной форме заказа. Используйте отдельную карточку с нужными полями либо оставьте услугу скрытой до доработки интеграции.
Название допустимо использовать только как дополнительный признак. Недостаток такого правила — поставщик может изменить формулировку, добавить сокращение или использовать другое написание. Критичные маршруты привязывайте к внешнему ID и проверяемым параметрам ответа.
Разделите данные API и настройки карточки
Импорт не должен полностью перезаписывать карточку витрины. Закупочная цена, лимиты, доступность и технические параметры обычно обновляются от поставщика. Название для клиента, описание, видимость, порядок показа и правила наценки остаются внутренними настройками панели.
Для каждого поля назначьте источник истины. Например, минимальный объём берётся из API, клиентское название — из панели, а цена витрины рассчитывается по внутреннему правилу на основе закупочной стоимости. Без такого разделения синхронизация может стереть вручную отредактированное описание или изменить категорию по внешнему названию.
Проверяйте изменения цены и параметров
Если поставщик изменил цену, пересчитайте цену витрины по правилу карточки и проверьте валюту, комиссии и допустимую маржу. При отсутствующей цене, неизвестной валюте или заметном изменении условий маршрут лучше перевести в статус проверки.
При изменении минимума, максимума или шага количества обновите форму заказа. Если форма не поддерживает новые ограничения, снимите маршрут с продажи. Иначе клиент оформит заказ, который поставщик отклонит после отправки.
Если изменились формат ссылки, обязательное поле, тип услуги или способ запуска, блокируйте новые заказы до ручной проверки. Недостаток строгой блокировки — часть карточек временно исчезнет из витрины, но это безопаснее, чем принимать несовместимые заказы.
Обрабатывайте ошибки API и ограничения запросов
Ошибка одного запроса не должна автоматически отключать весь каталог. Разделяйте ошибки авторизации, некорректного запроса, временной недоступности и ограничения частоты запросов. Для каждой группы нужен отдельный сценарий.
- При ошибке авторизации остановите новые заказы этому поставщику и проверьте доступ.
- При ошибке формата запроса сохраните ответ API и исправьте интеграцию без бесконечных повторов.
- При временной ошибке повторите запрос с увеличивающейся паузой.
- При ограничении частоты сохраните текущий курсор и перенесите задачу на повтор.
Не помечайте услуги пропавшими, пока отложенная синхронизация не завершится успешно. Недостаток агрессивных повторов — можно быстрее исчерпать лимит запросов и оставить каталог устаревшим на более долгий срок.
Сохраняйте маршруты для активных заказов
Статус услуги и статус заказа — разные сущности. Услуга может исчезнуть из каталога для новых клиентов, но старые заказы по ней всё ещё выполняются. Архивация карточки или маршрута не должна останавливать опрос статусов уже созданных заказов.
Для каждого заказа сохраняйте внешний ID услуги, внешний ID заказа, отправленные параметры, закупочную стоимость на момент запуска и историю статусов. Если поставщик сообщает о частичном выполнении, отмене или ошибке, обработайте ситуацию по правилам панели: возврат, компенсация, дозапуск или ручная проверка.
Недостаток хранения снимка параметров заказа — потребуется больше места и аккуратная схема данных. Без такого снимка невозможно установить, на каких условиях заказ был отправлен, если поставщик позже поменял услугу.
Тестируйте маппинг до публикации карточек
После настройки проверьте полный путь: создание заказа в панели, выбор маршрута, отправку поставщику, сохранение внешнего ID, получение статуса, отмену и обработку частичного выполнения. Тестируйте группы услуг с разными лимитами, ссылками и обязательными полями.
Отдельно смоделируйте повторный импорт, изменение цены, исчезновение услуги после успешного полного обхода, ошибку на середине пагинации и ограничение частоты запросов. Это покажет, не архивирует ли панель рабочие маршруты из-за неполной загрузки каталога.
Особое внимание уделите ручным услугам и позициям с комментариями. Их недостаток — стандартная форма панели часто не передаёт все данные, которые ожидает поставщик. Для них нужен отдельный шаблон заказа или скрытый статус до доработки API-интеграции.
Новости и статьи
Что изменилось в дизайне и функционале Мы обновили сайт, чтобы работать с ним было быстрее и удобнее. Основные изменения касаются интерфейса, личного..
Доброго времени суток, собрал все новости за это время:1. Главная новость - сильно снижены цены на твич зрителей, пока твич откатил почти все защиты, ..
1. Используйте промокод "December2025" на 15% скидки на всех наших зрителей2. Мы снизили до 1 января базовые цены на наш конфигуратор и самую недорогу..
Твич работает стабильно, поэтому мы готовы сотрудничать со сквадами, реселлерами, сервисами, владельцами ботов и многими другими.Индивидуальные услови..
Мы полностью обновили зрителей для твича и они работают стабильно. Мы используем только качественные IP адреса для зрителей.Ньюанс заключается в заказ..
Всем доброго времени суток. Сегодня мы анонсируем новую функцию - "Конфигуратор Twitch зрителей".Теперь Вы сможете сами себе собрать любой тариф для т..
Приветствую, составил гайд для стримеров, который на данный момент будет очень актуален. Сейчас ютуб и твич отключили монетизацию с просмотров из РФ, ..
Мы наконец-то разработали API Теперь нашим сайтам партнерам будет удобнее с нами работать.Если есть вопросы по АПИ - пишите в TelegramЧто такое Resell..
В связи с огромной популярностью услуг партнёрства и реферальной программы, мы сделали таблицу сотрудничества. Суть очень простая: больше живой аудито..
Наши услуги для стримеров
YouTubeСтабильные зрители · Живые зрители · Лайки · Просмотры · Подписчики
TwitchПанель управления · Зрители uVHQ · Дешёвые MQ · Просмотры · Фолловеры · Битсы · Чат-боты
KickЗрители · Панель управления · Подписчики · Просмотры · Чат-боты
VK Video LiveЗрители · Просмотры · Подписчики · Лайки · Чат-боты
TrovoзакрытЗрители · Подписчики · Просмотры
DliveзакрытЗрители · Просмотры · Фолловеры
BigoЗрители · Просмотры
Наши услуги для контентмейкеров
VK.comПодписчики · Лайки · Просмотры · Комментарии · Голоса · Жалобы
TelegramПросмотры · Подписчики · Реакции · Бусты · Звёзды · Комментарии
InstagramПодписчики · Просмотры · Лайки · Комментарии · Репосты · Зрители
TikTokПодписчики · Лайки · Просмотры · Комментарии · Репосты · Зрители
DiscordПодписчики · Реакции · Бусты · Жалобы
FacebookПодписчики · Просмотры · Лайки · Реакции · Комментарии · Часы
TwitterПодписчики · Просмотры · Лайки · Комментарии · Репосты
ОдноклассникиКлассы · Подписчики · Просмотры