Support
Зіставлення послуг постачальника з категоріями SMM-панелі через API

Як пов'язати послуги постачальника з картками 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" }

Схема зв'язку ID послуги постачальника з категорією SMM-панелі та карткою вітрини

Зв'язки можуть бути різними, але для кожного заздалегідь визначте правило оновлення.

  • Одна послуга постачальника — одна картка, якщо в неї унікальні параметри та форма замовлення.
  • Кілька послуг різних постачальників — одна картка, якщо вони сумісні за вимогами та умовами.
  • Одна послуга постачальника — кілька карток, якщо вітрина розділяє її за мовою, сегментом або способом продажу.

У об'єднання кількох постачальників в одній картці є недолік: швидкість, доступність і фактичні умови виконання можуть відрізнятися. Не об'єднуйте маршрути з різними форматами посилання, лімітами або обов'язковими полями.

Імпортуйте каталог посторінково

Постачальник може віддавати каталог сторінками через номер, зсув або курсор. Перша відповідь не обов'язково містить усі послуги. Запитуйте наступну сторінку, доки API передає курсор, посилання на продовження або іншу явну ознаку наявності даних.

При курсорній пагінації обробка виглядає так: панель отримує сторінку, зберігає всі послуги, фіксує їх як знайдені в поточному циклі й лише потім переходить до наступного курсора. Якщо поле next_cursor відсутнє, обхід вважається завершеним.

  1. Створіть ідентифікатор поточного циклу синхронізації.
  2. Запросіть першу сторінку та збережіть отримані послуги.
  3. Для кожної послуги оновіть поле last_seen_sync ідентифікатором циклу.
  4. Збережіть курсор наступної сторінки до виконання наступного запиту.
  5. Після успішного обходу всіх сторінок порівняйте каталог із поточним циклом.

Недолік послідовного завантаження сторінок — повний імпорт може тривати довше. Паралельні запити прискорюють процес, але підвищують ризик упертися в обмеження 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-інтеграції.

Останні статті

Новий дизайн сайту

Що змінилося в дизайні та функціоналі Ми оновили сайт, щоб працювати з ним було швидше та зручніше. Основні зміни стосуються інтерфейсу, особистого к..

15.08.2026 Нове

Новости сервиса за последнее время

Доброго времени суток, собрал все новости за это время:1. Главная новость - сильно снижены цены на твич зрителей, пока твич откатил почти все защиты, ..

08.04.2026 Оновлення

Зібрали для Вас усі поточні акції та розіграші до 01.01.2026

1. Використовуйте промокод "December2025" на 15% знижки для всіх наших глядачів2. Ми знизили до 1 січня базові ціни на наш конфігуратор і най дешевшу ..

26.12.2025 Завершена

Співпраця з командами та реселерами

Послуги Twitch працюють стабільно, тому ми готові співпрацювати з командами, реселерами, власниками сервісів, ботами і багатьма іншими.Індивідуальні..

22.10.2025 Партнерам

Глядачі Twitch працюють стабільно, але є деякі нюанси.

Ми повністю оновили наші послуги перегляду Twitch, і тепер вони працюють стабільно. Ми використовуємо лише якісні IP-адреси для перегляду.Нюанс поля..

22.10.2025 Оновлення

Конфигуратор Twitch зрителей

Всем доброго времени суток. Сегодня мы анонсируем новую функцию - "Конфигуратор Twitch зрителей".Теперь Вы сможете сами себе собрать любой тариф для т..

15.06.2025 Нове

Если ютуб все, где сейчас стримить?

Приветствую, составил гайд для стримеров, который на данный момент будет очень актуален. Сейчас ютуб и твич отключили монетизацию с просмотров из ..

16.03.2022 Важливо

API SP

Мы наконец-то разработали API Теперь нашим сайтам партнерам будет удобнее с нами работать.По обновлению максимальных тарифов на ютуб - апдейт уже на п..

02.09.2021 Партнерам

ПАРТНЕРИ ТА РЕФЕРАЛИ: НОВІ УМОВИ!

У зв'язку з величезною популярністю послуг партнерства та реферальної програми ми зробили таблицю співпраці.Суть дуже проста: більше живої аудиторії –..

12.08.2020 Партнерам

Панель керування глядачами [Twitch | Kick | YouTube | VK Video Live]

Створи свій індивідуальний тариф
Поповнення балансу, замовлення в один клік, знижки та бонуси доступні лише для зареєстрованих користувачів. Зареєструватися.
Якщо ви не знайшли потрібну послугу або знайшли дешевше - напишіть у підтримку в Telegram або чат, і ми вирішимо будь-яке питання.

 

Наші послуги для стрімерів

 

Наші послуги для контент-мейкерів

 

Нове

Telegram-бот @BOT_SP_RU_BOT

Замовлення й повтор за хвилину, баланс і статуси замовлень — просто в Telegram

Повтор замовленняСтатуси замовленьПоповнення балансуПромокоди