Главная
Xtream UIPro

Центр помощи

Вопросы и ответы

Как работают кредиты, пакеты, линии, ссылки для просмотра и устройства — и что проверить, если что-то не воспроизводится.

139 из 139 вопросов

Что-то не воспроизводится? Большинство проблем решает чек-лист в разделе «Устранение неполадок». Начните с него. Открыть устранение неполадок

Как пользоваться этой страницей

У каждого вопроса есть постоянный код (например,LINE-07). Называйте его при обращении в поддержку или скопируйте ссылку на вопрос.

Названия меню, кнопок и полей написаны так, как их показывает панель.Пользователь(user) — это аккаунт, который входит в панель (админ, реселлер);линия(line) — это IPTV-подписка зрителя. Эти понятия никогда не смешиваются.

  • Зритель Реселлер может переслать этот ответ зрителю как есть
  • Админ Для оператора панели

Обзор сервиса и зоны ответственности

GEN
GEN-01 Что предоставляет этот сервис?

Полноценную OTT / IPTV-систему: панель администратора (dashboard), API-сервер для приложений зрителей, доставку live-каналов, фильмов, сериалов и радио, а также веб-плеер. Мы предоставляем и поддерживаем систему; реселлеры используют её, чтобы давать своим клиентам право на просмотр (линии).

#GEN-01
GEN-02 Чего сервис не делает?
  • Он не собирает деньги за вас и не имеет платёжного шлюза. Цена для ваших клиентов, способ получения оплаты и выставление счетов — дело реселлера (см.CON-01).
  • Он не связывается со зрителями реселлера. Панель отправляет email только аккаунтам панели, но никогда не линиям.
  • Он не хранит персональные данные удалённого клиента и не имеет функции восстановления (см.DATA-01).
#GEN-02
GEN-03 Кто есть кто в системе?
РольКто этоГде входит
Админоператор панелиdashboard
Реселлерпродаёт линии; получает кредиты от админаdashboard, Reseller API
Суб-реселлерреселлер, созданный ниже другого реселлераdashboard, Reseller API
Линияподписчик — конечный зрительIPTV-приложение, приставка, веб-плеер.Никогдане dashboard
#GEN-03
GEN-04 Какие шаги доводят канал до зрителя?
  1. Админ формирует каталог (каналы, фильмы, сериалы, радио) и объединяет его вбукеты(bouquets).
  2. Админ создаётпакет(package): букеты + срок + число подключений + цена в кредитах.
  3. Реселлер тратит кредиты на продажу пакета → система создаётлинию.
  4. Клиент вводит данные линии в приложении; система проверяет линию (не истекла, включена, в пределах лимитов) и воспроизводит с подходящего сервера.
#GEN-04
GEN-05 Что реселлер может делать с контентом, а что нет?

Реселлер можетпросматриватьсписки каналов, фильмов, сериалов, радио, букетов и пакетов (если у его группы есть разрешение), но не может добавлять, редактировать или удалять контент. Контентом и пакетами управляет админ. Реселлер определяет, что может смотреть каждый клиент, выбирая пакет (и букеты, если группа это позволяет —PKG-05).

#GEN-05
GEN-06 Где получить поддержку?

ПунктSupportв боковом меню открывает отдельный сайт поддержки. Собственной тикет-системы в панели нет. Отправляя запрос, укажите: имя пользователя линии (никогда не пароль), время события, приложение / устройство и код вопроса с этой страницы, если вы уже его пробовали.

#GEN-06
GEN-07 Какие языки есть в интерфейсе?

В панели, веб-плеере и на этой странице помощи есть переключатель языков с 27 языками. Английский и вьетнамский — эталонные переводы; на других языках только что добавленный экран может какое-то время оставаться на английском. Письма, которые отправляет панель, пока только на английском.

#GEN-07

Аккаунты панели и вход

ACC
ACC-01 Почему мой клиент не может войти в dashboard?

Так задумано: линия — это не аккаунт панели. Клиент использует данные линии только в IPTV-приложении, приставке или веб-плеере. И наоборот, аккаунт реселлера нельзя использовать для просмотра каналов.

#ACC-01
ACC-02 Я вижу меньше меню, чем описано на этой странице. Почему?

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

#ACC-02
ACC-03 Где сменить пароль панели?

В разделе аккаунта (профиль → смена пароля). Пароли панели хранятся в виде хеша; прочитать их не может никто — даже админ. Если вы его забыли, попросите вышестоящий аккаунт (вашего родительского реселлера или админа) задать новый.

#ACC-03
ACC-04 Почему меня выбрасывает из аккаунта при смене сети?

Панель можно настроить так, чтобы сессия завершалась при смене IP-адреса — это не даёт использовать украденную сессию. Войдите заново. Это настройка админа.

#ACC-04
ACC-05 Что будет после нескольких неверных попыток входа?

Панель ограничивает число неудачных входов (настраивает админ). После превышения лимита нужно подождать, прежде чем пробовать снова.

#ACC-05
ACC-06 Чем демо-аккаунт отличается от настоящего?

Демо-аккаунт только показывает интерфейс: он не может сменить пароль, изменить профиль, создать коды активации или сделать что-либо необратимое.

#ACC-06
ACC-07 Мой аккаунт «отключён». Что это значит?

Вышестоящий аккаунт отключил его: вы не можете войти в панель, а ваши API-ключи отклоняются. Уже проданные линии не удаляются. Свяжитесь с вышестоящим аккаунтом.

#ACC-07
ACC-08 Где посмотреть, что делали я и мои суб-реселлеры?

Logs → Reseller Logs(если группе разрешён просмотр логов): каждая созданная, изменённая, продлённая, включённая / отключённая или удалённая линия или устройство, каждый созданный суб-реселлер и каждый перевод кредитов — со списанными кредитами. Вы видите только свои записи и записи аккаунтов ниже вас; журнал нельзя удалить (только админ). Для сверки баланса по-прежнему служит журнал кредитов (CRD).

#ACC-08

Кредиты

CRD
CRD-01 Что такое кредит?

Предоплаченная единица панели. Каждая продажа (создание линии, продление, создание кодов активации, создание суб-реселлера) списывает кредиты по цене пакета или по тарифу группы. Кредит — это не деньги, и панель их не конвертирует: сколько стоит один кредит, договариваются вы и вышестоящий аккаунт.

#CRD-01
CRD-02 Как пополнить кредиты?

Кредиты идут сверху вниз: админ выдаёт кредиты реселлеру, реселлер переводит их суб-реселлеру. Оплата вышестоящему аккаунту происходит вне панели.

#CRD-02
CRD-03 Чьи кредиты списываются?

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

#CRD-03
CRD-04 Где посмотреть историю кредитов?

СтраницаCredits: одна строка на каждое движение, с датой, суммой, балансом после операции, причиной и тем, кто её выполнил. Это журнал — достоверный источник вашего баланса.

#CRD-04
CRD-05 Что, если кредитов не хватает?

Всё действие отклоняется: линия не создаётся и ничего не списывается. Баланс никогда не уходит в минус.

#CRD-05
CRD-06 Спишутся ли кредиты дважды, если я нажму «сохранить» два раза или пропадёт сеть?

Нет. Каждый запрос на продажу несёт идентификатор запроса (request_id); повторная отправка того же идентификатора возвращает прежний результат. Создание линии и списание кредитов всегда выполняются вместе или отменяются вместе.

#CRD-06
CRD-07 Возвращаются ли кредиты, если я удалю линию?

Нет. Удаление линии ничего не возвращает, даже если у неё остался срок. Единственное исключение: удалениенеиспользованного кода активации, созданного реселлером, возвращает кредиты (CODE-08).

#CRD-07
CRD-08 Можно ли забрать обратно кредиты, переведённые суб-реселлеру?

Да: в форме редактирования суб-реселлера введите отрицательное число в поле перевода кредитов. Баланс не может опуститься ниже 0.

#CRD-08
CRD-09 Как заранее узнать, сколько линий я могу купить?

Селектор пакета в форме линии показывает вашу собственную цену. Через API действиеpricingвозвращает ваш баланс, цену каждого пакета и сколько штук вы можете себе позволить.

#CRD-09

Пакеты, букеты и цены

PKG
PKG-01 Чем букет отличается от пакета?

Букет(bouquet) — это список контента (каналы, фильмы, сериалы).Пакет(package) — это продукт, который вы продаёте: один или несколько букетов, срок, число подключений, форматы вывода, блокировки и цена в кредитах (обычная цена и цена триала).

#PKG-01
PKG-02 Почему я не вижу некоторый пакет?

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

#PKG-02
PKG-03 Моя цена отличается от цены пакета. Почему?

Админ может задатьсобственную ценудля каждого реселлера по каждому пакету (0 = бесплатно). Собственная цена применяется при создании обычной линии, продлении и обычных кодах активации; к триалам онанеприменяется.

#PKG-03
PKG-04 Если админ меняет букеты пакета, изменятся ли уже проданные линии?

Нет. Букетыкопируются в линиюв момент продажи; последующее редактирование пакета не влияет на уже проданные линии. Новые букеты пакета линия получит при следующем продлении / смене пакета. (Когда меняется контентвнутрибукета, это сразу видят все линии с этим букетом. Удаление букета убирает его идентификатор из всех линий и пакетов. Изменение глобального порядка букетов меняет порядок, сохранённый в проданных линиях, только если вы отметите флажок «применить к проданным линиям и пакетам»; набор букетов линии при этом не меняется.)

#PKG-04
PKG-05 Можно ли продать только часть пакета?

Только если у вашей группы включеноAllow Bouquet Selection: вы отмечаете часть букетов пакета; ничего не отмечено = весь пакет; букеты вне пакета отбрасываются. Цена не меняется.

#PKG-05
PKG-06 Какие свойства линии определяются пакетом?

Дата окончания (сегодня + срок пакета), число подключений, форматы вывода, рестример, привязка к устройству, принудительная страна, принудительный сервер, привязка к провайдеру (ISP lock), букеты. Значения, которые реселлер вводит для этих полей, игнорируются, кроме букетов (PKG-05) и ISP lock, если у группы включеноAllow Line Restrictions.

#PKG-06
PKG-07 Что такое пакет «MAG only» / «Enigma only»?

Пакет, который можно продать только для приставки такого типа; его нельзя продать для обычной линии или для устройства другого типа. И наоборот, чтобы использовать пакет в форме Add MAG / Add Enigma, он должен разрешать этот тип устройства.

#PKG-07

Линии: создание, правка, продление, удаление

LINE
LINE-01 Что нужно для создания линии?

Нужно выбрать пакет, который ваша группа может продавать, и иметь достаточно кредитов. Имя пользователя / пароль: введите свои (если группа позволяет) или оставьте поля пустыми, чтобы они были сгенерированы. Админ при создании линии тоже может оставить одно из них (или оба) пустыми: система сгенерирует 10 символов и покажет их сразу после сохранения; формередактированияимя пользователя всё равно необходимо.

#LINE-01
LINE-02 Почему я не могу сам выбрать имя пользователя / пароль?

У вашей группы выключеноAllow Username Change/Allow Password Change: новая линия получает сгенерированные значения. Если вы можете вводить свои, минимальную длину задаёт группа (по умолчанию 8 символов).

#LINE-02
LINE-03 Где снова посмотреть пароль линии?

В форме редактирования линии и в диалогеGenerate play linkв списке Lines. Пароли линий хранятся в читаемом виде, потому что они нужны IPTV-приложениям и ссылкам на плейлист. Сгенерированный пароль показывается сразу после сохранения.

#LINE-03
LINE-04 У старой линии не показан пароль, и клиент не может войти?

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

#LINE-04
LINE-05 Что реселлер может редактировать в линии после продажи?

Включение / отключение, заметки реселлера, контакт, шаблон категорий, владельца (в пределах вашего дерева); имя пользователя и пароль, если группа позволяет; ограничения (IP, user agent, ISP lock), если у группы включеноAllow Line Restrictions; новый выбор букетов в рамках пакета, если группа позволяет. Пакет, дату окончания, число подключений, флаг триала, форматы вывода, привязку к устройству и страну напрямуюнельзяизменить — они меняются только через продление / смену пакета.

#LINE-05
LINE-06 Как продлить линию?

Два способа, одно правило:

  • кнопкаRenew (charged)в списке: использует текущий пакет линии;
  • полеExtend with packageв форме редактирования: выберите любой пакет, который вы можете продавать (так же выполняетсясмена пакета).

Если вы редактируете линию и выбираете продление в одном сохранении, обе операции —одна транзакция: если продление отклонено (не хватает кредитов, пакет нельзя продавать), правка тоженесохраняется и кредиты не списываются. Исправьте и сохраните снова.

#LINE-06
LINE-07 Сохраняется ли оставшееся время при продлении?
  • Линияне истекла, а новый пакетсовместимсо старым → время добавляется к текущей дате окончания.
  • Линияистеклаили пакеты несовместимы → отсчёт ведётся от сегодняшнего дня; остаток времени не сохраняется.

«Совместимость» проверяется, только если у нового пакета включена опция проверки совместимости: у обоих пакетов должны совпадать букеты, форматы вывода, число подключений, флаг рестримера и привязка к устройству. При выключенной опции пакеты всегда считаются совместимыми. У новых пакетов опция включена по умолчанию (админ может её выключить); у существующих пакетов настройка сохраняется. Линию MAG / Enigma можно продлить или перевести только на пакет, который допускает такой тип приставки.

#LINE-07
LINE-08 Как тарифицируется смена пакета (апгрейд / даунгрейд)?

Смена пакета = покупка одного обычного периода нового пакета: списывается полная цена нового пакета (ваша собственная цена, если она есть), без зачёта неиспользованной части. Линия получает все свойства нового пакета.

#LINE-08
LINE-09 Чем отключение линии отличается от удаления?

Отключение: клиент не может войти и смотреть, текущие сессии закрываются примерно в течение минуты; срок подписки продолжает идти; вы можете включить линию снова в любой момент.Удаление: безвозвратно, без восстановления и без возврата кредитов (DATA-01). Если клиент делает паузу — отключайте, не удаляйте.

#LINE-09
LINE-10 Что означают статусы линии?
СтатусЗначениеКто может снять
Activeможно использовать—
Disabledотключена реселлером / владельцемреселлер
Bannedзаблокирована админомтолько админ
Expiredпрошла дата окончанияпродление
Trialпробная линия, доступна до конца пробного периодастановится обычной при продлении
#LINE-10
LINE-11 Что происходит, когда линия истекает?

Клиенту отказывают до продления линии (линия, которая одновременно истекла и забанена, видит ролик «истекла», потому что срок проверяется первым); текущие сессии закрываются примерно в течение минуты. Линиянеудаляется автоматически: продлите её, и она снова заработает с теми же именем пользователя / паролем.

#LINE-11
LINE-12 Можно ли передать линию суб-реселлеру?

Да: выберите владельцем аккаунт ниже вас. Владелец видит линию в своём списке. Кредиты по-прежнему списываются с того, кто нажимает «сохранить».

#LINE-12
LINE-13 Чьи линии я вижу?

Свои и линии всех аккаунтов ниже вас. Линия вне вашего дерева для вас не существует (ответ — «не найдено»).

#LINE-13
LINE-14 Для чего нужны поля «Contact» и «Reseller notes»?

Чтобы вы помнили, кто этот клиент (email, телефон, номер заказа). Подписчик их никогда не видит. Они безвозвратно стираются при удалении линии.

#LINE-14
LINE-15 Можно ли увидеть, что смотрит линия и откуда?

Если у группы есть разрешение:Logs → Line Activityпоказывает историю просмотров каждой линии, аLogs → Live Connections— все открытые подключения линий в вашем дереве (какая линия, какой канал, с какого адреса) с кнопкой для их закрытия. Live Connections открывается, только если админ включил для вашей группы просмотр истории подключений клиентов (флажокclient connection logsв форме группы); подключения линий вне вашего дерева вы не видите никогда.

#LINE-15
LINE-16 Почему в списке Lines нет линий кодов активации?

Линия, принадлежащая коду активации, по умолчанию скрыта из списка, пока вы не отфильтруете её (CODE-02).

#LINE-16
LINE-17 Включает ли дата окончания в форме линии время? Админ

Да. ПолеExpires onв форме линии — это датаи времяв часовом поясе панели, поэтому линия может истекать в определённый час. Если открыть форму и сохранить, не трогая это поле, срок сохраняется с точностью до секунды — правка заметки или букетов не даёт почасовой пробной линии дополнительного времени. Значение, которое не удаётся прочитать, помечается ошибкой у самого поля и никогда не превращается в «бессрочно». Страница массового редактирования по-прежнему принимает дату, которая читается как конец этого дня.

#LINE-17

Триалы

TRI
TRI-01 Когда я могу создать пробную линию?

Когда выполняетсявсёперечисленное: админ не отключил триалы для реселлеров; у пакета есть пробный период; у вашей группыAllowed Trials> 0; ваши кредиты ≥Minimum Trial Creditsгруппы; а число пробных линий, созданных вами за расчётный период, не достигло квоты.

#TRI-01
TRI-02 За какой период считается квота триалов?

Как задано в группе:день= последние 24 часа,месяц= последние 30 дней. Пример, квота 5 / день: не более 5 пробных линий за любые 24 часа. Более старый триал освобождает слот, когда выходит за пределы периода.

#TRI-02
TRI-03 Стоит ли триал кредитов?

Ровно цену триала пакета (обычно 0). Собственная цена реселлера к триалам не применяется.

#TRI-03
TRI-04 Почему флажок триала заблокирован?

Не выполнено одно из условийTRI-01; форма указывает причину рядом с флажком.

#TRI-04
TRI-05 Как превратить триал в обычную линию?

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

#TRI-05
TRI-06 Можно ли дать существующей линии ещё один пробный период?

Нет. Триал выдаётсяодин раз, при создании линии; существующую линию можно только продлить обычным периодом (TRI-05). Чтобы клиент мог попробовать снова, создайте новую пробную линию (она учитывается в квоте триалов).

#TRI-06

Ссылки для просмотра, приложения и форматы

PLAY
PLAY-01 Где взять ссылку для моего клиента?

Lines → Generate play link: выберите формат; ссылка строится с именем пользователя и паролем линии. Через APIget_lineвозвращает готовые ссылки:m3u,m3u_hls,xmltv,player_api,web_player.

#PLAY-01
PLAY-02 Какие приложения может использовать клиент? Зритель

Любое приложение с поддержкойXtream Codes API(IPTV Smarters, TiviMate, XCIPTV, GSE…): введите адрес сервера + имя пользователя + пароль. Для приложения, принимающего только плейлист, используйте ссылкуM3U. ПриставкиMAGиспользуют портал, приставкиEnigma2— плейлист / плагин. Без какого-либо устройства используйтевеб-плеерв браузере.

#PLAY-02
PLAY-03 MPEG-TS или HLS?

MPEG-TS: быстрое переключение каналов, подходит для IPTV-приложений и приставок.HLS: хорошо работает в браузерах, на устройствах Apple и в нестабильных сетях. Линия может использовать только форматы, которые разрешает её пакет; ссылка в неразрешённом формате отклоняется.

#PLAY-03
PLAY-04 Какие бывают типы плейлистов?

m3u_plus(с логотипами, группами, EPG-идентификаторами — рекомендуемый вариант по умолчанию), простойm3u, типы для Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive и простые списочные типы. Выберите нужный в диалоге Generate play link.

#PLAY-04
PLAY-05 Откуда берётся телепрограмма (EPG)? Зритель

Xtream-приложения получают её сами. Для M3U-приложения используйте ссылкуXMLTVлинии (плейлистm3u_plusуже содержит адрес EPG).

#PLAY-05
PLAY-06 Есть ли catch-up? Зритель

Да, на каналах, для которых админ включил архив; приложения показывают значок catch-up на таких каналах.

#PLAY-06
PLAY-07 Где веб-плеер и как в него войти? Зритель

По адресу/player/на API-сервере (ссылкаweb_player). Входите с именем пользователя / паролем линии или с кодом активации.

#PLAY-07
PLAY-08 Работает ли старая ссылка после смены пароля линии?

Нет. Пароль входит в ссылку и сохранён в приложении; после смены пароля клиенту нужно ввести его заново / получить новую ссылку. Так же можно отключить того, кто пользуется линией без разрешения.

#PLAY-08
PLAY-09 Можно ли использовать собственный домен для ссылок для просмотра?

Да: задайтеYour own play addressна странице API-ключа (или через API-действиеset_play_base). Вы направляете DNS домена на API-сервер панели,иоператор должен настроить свою сторону; сообщите админу, прежде чем использовать это. Адрес применяется к ссылкам, которые API возвращает вашей системе.

#PLAY-09
PLAY-10 Можно ли дать одну ссылку нескольким людям?

Технически они делят одну линию, а значит, и еёчисло подключений(SEC-01), и могут столкнуться с правилом второго IP (SEC-03). У каждого клиента должна быть своя линия.

#PLAY-10

Приставки MAG / Enigma2

DEV
DEV-01 Как добавить приставку MAG / Enigma?

Devices → Add MAG / Add Enigma: введите MAC, выберите пакет. Система продаёт новую линию и привязывает устройство за один шаг; устройство входит по своему MAC, имя пользователя / пароль вводить никому не нужно. Кредиты списываются так же, как для обычной линии.

#DEV-01
DEV-02 У клиента уже есть линия, и он хочет добавить приставку?

В форме устройства выберитесуществующую линиюклиента вместо пакета: устройствосвязываетсяс этой линией бесплатно. Клиент продолжает пользоваться линией в приложении; приставка следует за пакетом, сроком, букетами и статусом линии.

#DEV-02
DEV-03 Как считаются подключения для связанных приложения и приставки?

Ониделятлимит подключений: приложение и приставка — один подписчик.

#DEV-03
DEV-04 Как продлить приставку?

Продлите её линию (ссылка есть в форме устройства). Для связанного устройства продлите линию клиента — приставка последует за ней сама.

#DEV-04
DEV-05 Клиент заменяет приставку на новую?

Измените MAC в устройстве. Если у линии включена привязка к устройству, сбросьте записанный серийный номер / идентификатор устройства, чтобы новая приставка могла зарегистрироваться.

#DEV-05
DEV-06 Удаляется ли линия при удалении устройства?

Да. Удаление устройства удаляет и его линию (вместе с историей подключений и ожидающими событиями), как в старой панели. Чтобы сохранить оплаченную линию, используйте кнопкуConvert to line: устройство удаляется, а линия становится обычной. Когда вы удаляете линию клиента, связанное устройство продолжает жить самостоятельно со своей линией.

#DEV-06
DEV-07 Может ли реселлер управлять приставкой удалённо?

Своими приставкамиMAG— да: отправить сообщение на ТВ, запустить канал, перезагрузить портал, перезагрузить устройство, закрыть подключения линии (группе нужно разрешение на просмотр логов подключений клиентов), сбросить записанного провайдера (ISP) и сбросить блокировку STB. Команды X-Plugin и скриншоты приставокEnigma, бан устройства и перенос устройства на другую линию доступны только админу. Включение / отключение устройства реселлера включает / отключает его линию; реселлер не может снятьBannedс устройства.

#DEV-07

Коды активации

CODE
CODE-01 Для чего нужен код активации?

Продажа доступа в виде кода (скретч-карта, код, отправленный сообщением): клиент вводит код в приложении или в веб-плеере и может смотреть без имени пользователя / пароля. Срокначинается только тогда, когда клиент впервые активирует код.

#CODE-01
CODE-02 Как создавать коды и сколько они стоят?

Active Codes → New: выберите пакет, количество (1–500 в одной партии), длину кода (6–24), вариант «только цифры» (удобно вводить пультом ТВ), вариант триала. Кредиты списываютсяпри создании= цена пакета × число кодов. К каждому коду прилагается своя линия, заблокированная до активации.

#CODE-02
CODE-03 Какие символы содержит код?

Заглавные буквы и цифры без легко путаемых символов (0, O, 1, I) либо только цифры. Если клиент вводит строчные буквы, код всё равно принимается.

#CODE-03
CODE-04 На скольких устройствах можно использовать один код? Зритель

На одном. Код привязывается к первому устройству, которое его активирует; другое устройство, вводящее тот же код, получает отказ. Это устройство может вводить код сколько угодно раз, данные входа линии при этом не меняются.

#CODE-04
CODE-05 Что делать, если клиент сменил устройство?

ВыполнитеReset deviceдля этого кода; после этого новое устройство сможет его активировать. Время к сроку не добавляется.

#CODE-05
CODE-06 Клиент получает ошибку при вводе кода. Что она означает? Зритель
СообщениеЗначениеЧто делать
INVALID_CODEневерный код / кода не существуетпроверьте каждый символ; не вводите дефисы
DEVICE_MISMATCHкод привязан к другому устройствуреселлер сбрасывает устройство (CODE-05)
DISABLEDкод отключёнреселлер включает его снова
EXPIREDсрок закончилсякупить код / продлить

Если подряд ввести несколько разных неверных кодов, IP-адрес на некоторое время блокируется (SEC-08).

#CODE-06
CODE-07 Как продлить активированный код?

На страницеActive Codesотметьте код, выберите действиеExtend (days)и введите число дней. Дни добавляются толькоактивированномукоду (у неиспользованного срок ещё не начался); действующий код продлевается от текущей даты окончания, истёкший — от текущего момента. Это действие не списывает кредиты. Через API:extend_active_code.

#CODE-07
CODE-08 Возвращаются ли кредиты при удалении кода?

Неиспользованныйкод, созданный реселлером: возврат полностью, с записью в журнале кредитов.Активированныйкод: без возврата.

#CODE-08
CODE-09 Как управлять сразу многими кодами?

СтраницаBatchesпоказывает по каждой партии всего / готовых / активированных / отключённых и экспортирует TXT-файл (один код на строку). Массовые действия: включить, отключить, сбросить устройство, удалить.

#CODE-09
CODE-10 Соблюдает ли линия кода активации лимиты пакета?

Да, как и любая линия, проданная с этим пакетом: число подключений, форматы вывода, букеты, привязка к устройству, рестример, а такжепринудительная странапакета (SEC-07). Клиент, который активирует код из страны вне списка разрешённых, сможет его активировать, но получит отказ при воспроизведении.

#CODE-10

Лимиты подключений и блокировки, защищающие линию

SEC
SEC-01 Как считается «Max connections»?

Это число устройств, которые смотрятодновременнос одной линии. 0 = без ограничений. Повторное открытие канала, который вы уже смотрите, с того же устройства не считается новым подключением.

#SEC-01
SEC-02 Кого отключают при превышении лимита? Зритель

По умолчанию:новоеподключение проходит, асамое староезакрывается (предпочтение отдаётся подключению с того же устройства, затем с того же IP). Закрытый плеер останавливается примерно через 30 секунд. Админ может переключить поведение наотказ новому подключениювместо закрытия старого.

#SEC-02
SEC-03 Что такое правило «второго IP»?

Когда админ его включил: пока линию смотрят с одного IP, live-подключение с другого IP отклоняется. Правило можно ограничить линиями с малым числом подключений (например, линиями с 1 подключением; линия с неограниченным числом подключений привязывается только при пороге 0). При включённомMatch The Address By Networkадреса одной сети /24 (IPv6: /64) считаются одним зрителем. Это средство против передачи аккаунта другим.

#SEC-03
SEC-04 Можно ли ограничить линию определёнными IP или приложениями?

Если у группы включеноAllow Line Restrictions: полеAllowed IPs(IP, диапазон CIDR или доменное имя, по одному в строке; домен разрешается в момент подключения, поэтому динамический IP тоже работает) иAllowed User-Agents. Пусто = разрешено всё. Учтите: эти ограничения блокируютвоспроизведение; приложение по-прежнему входит и показывает список каналов.

#SEC-04
SEC-05 Что такое ISP lock?

Линия запоминает интернет-провайдера первого подключения и отказывает в использовании у другого провайдера. Когда клиент меняет провайдера, выключите и снова включите ISP lock, чтобы записать нового. На приставки MAG это не распространяется.

#SEC-05
SEC-06 Что такое привязка к устройству (device lock)?

Она привязывает линию к первой приставке, которая вошла (серийный номер, идентификатор устройства); другая приставка получает отказ. Определяется пакетом.

#SEC-06
SEC-07 Как работает ограничение по стране?

Линия может подключаться только из своей принудительной страны (ALL= откуда угодно). Если оно пусто, действует общий список разрешённых стран панели. Клиент, который путешествует за границей или использует VPN, может получить отказ по этой причине.

#SEC-07
SEC-08 Почему IP-адрес заблокирован? Зритель
  • Автоматически: неудачные входы с одного IP под множеством разных имён пользователей / кодов активации за короткое время или поток запросов. Автоматическая блокировка снимается сама через время, заданное админом (по умолчанию 60 минут).
  • Вручную: админ заблокировал IP / диапазон IP; такая блокировка не истекает.

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

#SEC-08
SEC-09 По каким ещё причинам подключение может быть заблокировано?

Админ может блокировать поUser-Agent(приложению), поинтернет-провайдеру (ISP)и поASN(например, диапазоны хостингов / VPN). Линия, для которой админ включил «bypass UA», пропускает список блокировки приложений.

#SEC-09
SEC-10 Что такое рестример?

Линия для партнёра, который забирает потоки, чтобы распространять их дальше. На неё не действуют лимит подключений, правило второго IP, автоматическое завершение долгих сессий и блокировка по ASN. Определяется пакетом / админом; не предназначена для обычных зрителей.

#SEC-10
SEC-11 Обрывается ли очень длинная непрерывная сессия? Зритель

Админ может задать максимальную длительность непрерывной сессии; после неё сессия закрывается, и клиенту нужно нажать play, чтобы продолжить. Сессия, потерявшая сигнал примерно на 90 секунд, тоже считается закрытой.

#SEC-11
SEC-12 Как обнаружить линию, которой делятся или которую украли?
  • СтраницаTheft Detection(если у группы есть разрешение): ранжирует линии по числуразныхфильмов / серий, просмотренных за 1 час / 24 часа / 7 дней, с числом разных IP — необычно высокий показатель вызывает подозрение.
  • Страница активности линии: показывает используемые IP и устройства.
  • Что делать: сменить пароль линии (PLAY-08), включить ограничение по IP / ISP lock или отключить линию.
#SEC-12

Суб-реселлеры

SUB
SUB-01 Могу ли я создавать суб-реселлеров?

Если у вашей группы включеноCan Create Sub-Resellersи есть хотя бы одна группа вGroups for sub-resellers. Каждое создание списывает плату за создание (в кредитах), заданную в группе. Дерево реселлеров имеет не более 5 уровней.

#SUB-01
SUB-02 К какой группе относится суб-реселлер и что он может делать?

Вы выбираете группу из списка, который разрешает админ; эта группа определяет права суб-реселлера, продаваемые пакеты и квоту триалов.

#SUB-02
SUB-03 Чем я могу управлять у суб-реселлера?

Email, имя, пароль, статус, группа (из списка), заметки, перевод / возврат кредитов и все линии под ним. Менять его роль или владельца нельзя.

#SUB-03
SUB-04 Что суб-реселлер видит из моего?

Ничего: каждый аккаунт видит только то, что находится ниже него, но никогда вышестоящие уровни или другие ветви.

#SUB-04
SUB-05 Куда уходят линии и кредиты суб-реселлера, когда я его удаляю?

У группы должно быть включеноCan Delete Users. Оставшиеся кредиты, линии и дочерние аккаунты переходят каккаунту, который удаляет. Линии клиентов продолжают работать. Персональные данные удалённого аккаунта (имя пользователя, email, имя, пароль, API-ключи, заметки) стираются; это имя пользователя и email можно использовать снова.

#SUB-05
SUB-06 Получает ли новый суб-реселлер письмо?

Если админ включил приветственное письмо: новый аккаунт получает имя для входа и ссылку для входа. В письменикогданет пароля — пароль вы отправляете сами.

#SUB-06

Шаблоны категорий

CAT
CAT-01 Для чего нужен шаблон категорий?

Чтобы менять порядок, переименовывать или скрывать категории (live, фильмы, сериалы, радио), которые клиент видит в приложении, — для каждой линии отдельно, не затрагивая собственные категории панели.

#CAT-01
CAT-02 Что происходит, когда я скрываю категорию?

Весь контент этой категории тоже скрывается из приложения и плейлиста линий, использующих шаблон.

#CAT-02
CAT-03 Если я изменю шаблон, изменятся ли использующие его линии?

Да, сразу для каждой линии, которой назначен шаблон. Когда шаблон удаляется, его линии возвращаются к раскладке по умолчанию.

#CAT-03
CAT-04 Какие шаблоны я могу видеть и редактировать?

Видеть: свои и шаблоны аккаунтов ниже вас, системные шаблоны и шаблоны, которыми поделились вышестоящие уровни. Редактировать: только свои и шаблоны ниже вас. Чтобы изменить системный шаблон,продублируйтеего и отредактируйте копию.

#CAT-04
CAT-05 Какие ограничения стоит знать?

Пользовательский порядок категорий не применяется к части с фильмами / сериалами в M3U-плейлисте (названия и скрытие по-прежнему действуют). Приложения, использующие Xtream API, получают всё.

#CAT-05

Reseller API, API-ключи, вебхуки

API
API-01 Для чего нужен Reseller API?

Чтобы ваша собственная система (веб-магазин, биллинг, бот) продавала и управляла линиями / суб-реселлерами, не открывая dashboard. Адрес:{API}/reseller/v1, аутентификация заголовкомX-API-Key. Полная документация находится по адресу/docs/на API-сервере.

#API-01
API-02 Где получить API-ключ?

СтраницаAPI Key. Ключ показываетсяодин раз, при создании — скопируйте его сразу. Если вы его потеряли, создайте новый ключ (старый перестанет работать).

#API-02
API-03 Нужно ли использовать один ключ для всех систем?

Лучше нет. Создавайтедополнительный ключдля каждой системы: дайте ему имя, ограничьте IP / CIDR, которым разрешено его использовать, при желании сделайте еготолько для чтения(только списки и просмотр) и отзывайте его отдельно, не затрагивая другие ключи.

#API-03
API-04 Что умеет API?
ЗадачаДействие
Баланс, цены, сколько можно купить, правила имени пользователя / триалаuser_info,pricing,packages
Линииget_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line
Суб-реселлерыget_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user
Коды активациисоздание, список, включение / отключение, сброс устройства, удаление
Вебхуки, собственный адрес воспроизведения, журнал вызовов APIcreate_webhook…,set_play_base,api_logs

Каждое правило dashboard (группа, собственная цена, квота триалов, область дерева) действует через API точно так же.

#API-04
API-05 Если я повторю запрос после сетевой ошибки, спишутся ли кредиты дважды?

Нет, если вы отправляете тот жеrequest_idдля той же транзакции: система возвращает прежний результат.request_idпродленияпривязан к этой линии: его повторное использование для другой линии возвращает ошибку конфликта (HTTP 409), и другая линия не меняется — генерируйте новыйrequest_idдля каждой транзакции.

#API-05
API-06 Моя интеграция не работает. Как проверить самому?

На странице API Key есть таблицапоследних вызовов API(30 дней): действие, результат, код ошибки, адрес вызывающего, имя коннектора. Параметры никогда не записываются.

#API-06
API-07 Что такое вебхук и какие бывают события?

Панель сообщает вашей системе, когда что-то происходит, чтобы вам не приходилось постоянно спрашивать. События:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(за 3 дня),line.expired,credits.low(ниже заданного вами порога). Принимающий адрес должен быть https и доступен из интернета.

#API-07
API-08 Как понять, что вебхук подлинный?

Каждое уведомление несёт подписьX-Xtream-Signature: sha256=HMAC(secret, timestamp.body); секрет показывается один раз, при создании endpoint. Вебхук никогда не содержит пароль.

#API-08
API-09 Вебхук перестал отправлять?

Каждое уведомление пробуется 3 раза; endpoint, у которого 20 доставок подряд завершились неудачей, отключается. Исправьте проблему на своей стороне, используйтеSend test, затем создайте endpoint заново, если он был отключён.

#API-09
API-10 Возвращает ли API пароли линий?

Да, но только владельцу линии (вам и вышестоящим уровням в дереве). Не сохраняйте пароли линий в логах и не отправляйте их по небезопасному каналу.

#API-10
API-11 Может ли `edit_line` продлить линию?

Да, если вместе с ним отправитьpackage_id(старое имяpackageтоже принимается): помимо правки, действие продаёт один обычный период этого пакета точно так же, какchange_package— та же цена, тот жеrequest_id, а в ответе естьcredits_charged. Правка и продление — одна транзакция: если она отклонена (не хватает кредитов, неверный пакет, переданtrial), ничего не меняется.edit_lineбезпакета правит только имя пользователя, пароль, контакт и заметки и не трогает пакет и срок.

#API-11
API-12 Будет ли работать с этим API скрипт, написанный для старой (PHP) панели?

Не как есть. API сохраняет привычные имена действий, но это новый интерфейс: адрес/reseller/v1, API-ключ, созданный в этой панели, действия записи отправляются через POST, ошибки возвращаются как HTTP-статус с полемerror, а результат создания линии находится вdata.line. Используйте документацию по адресу/docs/или готовый коннектор (CON-02).

#API-12

Коннекторы для магазинов и биллинговых систем

CON
CON-01 Как собирать деньги с моих клиентов?

С помощьювашей собственнойсистемы и платёжного шлюза. Панель не обрабатывает платежи. Коннектор связывает вашу систему магазина с панелью: клиент платит на вашей стороне → коннектор вызывает Reseller API, чтобы создать / продлить линию.

#CON-01
CON-02 Для каких платформ есть коннектор?

WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, а также «webhook bridge» для Shopify, Upmind и Invoice Ninja.

#CON-02
CON-03 Где скачать и как установить?

Боковое менюResources → All Connectors: у каждого коннектора есть описание, данные для подключения, шаги установки, кнопкаDownloadи SHA-256 файла для проверки.

#CON-03
CON-04 Насколько протестированы коннекторы?

По-разному для каждого коннектора, и страница каждого из них об этом сообщает: одни запускались внутри настоящей платформы (например, WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), у других проверялось только ядро. Прочитайте строку «как это тестировалось» и испытайте коннектор в тестовой среде, прежде чем продавать по-настоящему.

#CON-04
CON-05 Безопасен ли коннектор и что он делает с панелью?

Коннектор только вызывает Reseller API свашимAPI-ключом — он может делать ровно то, что можете вы, и ничего больше. Исходный код открыт, вы можете его прочитать и проверить. Дайте каждому коннектору собственный ключ с ограничением по IP (API-03).

#CON-05
CON-06 Что может продавать коннектор?

Линии (создание, продление, смена пакета, приостановка, удаление) и аккаунты суб-реселлеров с кредитами.

#CON-06
CON-07 Для моей платформы коннектора пока нет?

Интегрируйте её сами с помощью Reseller API (API-01) и вебхуков либо отправьте запрос через канал поддержки.

#CON-07

Данные, удаление и конфиденциальность

DATA
DATA-01 Можно ли восстановить удалённую линию?

Нет. Удалено — значит исчезло: данные линии (имя пользователя, пароль, контакт, заметки), история её подключений (IP, устройства, что смотрели), приставки, привязанные к линии, и её код активации. Корзины, функции или API восстановления нет. Когда клиент вернётся, создайте новую линию.

#DATA-01
DATA-02 Что система хранит после удаления?

Толькоанонимнуюстатистическую запись для оператора (новый или вернувшийся клиент, какие пакеты популярны). В ней нет ничего читаемого о клиенте, и ни один реселлер, коннектор или API не может до неё добраться.

#DATA-02
DATA-03 Может ли резервная копия вернуть удалённую линию?

Нет. Резервные копии базы данных существуют только для восстановления системы после инцидента и хранятся у оператора; они не используются для отмены удаления. Старые копии ротируются, поэтому удалённые данные исчезают и из них.

#DATA-03
DATA-04 Почему пароль линии читаем, а пароль панели нет?

Пароль линии нужно вводить в приложениях, и он входит в ссылку на плейлист, поэтому панель хранит его в читаемом виде для владельца линии. Пароли аккаунтов панели хранятся только в виде хеша.

#DATA-04
DATA-05 Кто может видеть мои линии и клиентов?

Вы, вышестоящие аккаунты в вашем дереве и админ. Другие реселлеры и уровни ниже вас — не могут.

#DATA-05
DATA-06 Отправляет ли панель email / сообщения моим клиентам?

Никогда. Клиенты линии принадлежат реселлеру; вы связываетесь с ними через собственную систему.

#DATA-06
DATA-07 Предупредят ли меня до истечения линии?

Двумя способами: ежедневное сводное письмо о линиях, срок которых скоро истекает (если админ его включил; по умолчанию за 3 дня), и вебхукиline.expiring/line.expiredдля вашей системы.

#DATA-07

Устранение неполадок

FIX

Проверяйте сверху вниз. Большинство проблем вида «не удаётся смотреть» находятся в первых 5 строках.

FIX-01 Клиент не может войти / не может смотреть Зритель
#ПроверкаПризнакЧто делать
1Имя пользователя / парольприложение сообщает о неверных данныхсравните с формой линии (с учётом регистра, без пробелов); отправьте ссылку изGenerate play linkещё раз
2Срокприложение сообщаетExpiredпродлите (LINE-06)
3СтатусDisabled/Bannedвключите снова; приBannedобратитесь к админу
4Адрес серверане удаётся подключитьсяиспользуйте точный адрес и порт из ссылки для просмотра и правильныйhttp/https
5Число подключенийвыбрасывает, когда кто-то другой начинает смотретьSEC-01,SEC-02
6Заблокированный IPни одна линия не проходит из этой сетиSEC-08: дождитесь снятия блокировки или попросите админа снять её
7ISP lock / страна / Allowed IPsсбой только после смены сети, на мобильном интернете, с VPN или в поездкеSEC-04,SEC-05,SEC-07
8Форматссылка HLS / TS отклоняетсяиспользуйте формат, который разрешает пакет (PLAY-03)
9Заблокированное приложениесбой только в одном приложениипопробуйте другое приложение;SEC-09
#FIX-01
FIX-02 Вход работает и список показывается, но канал не воспроизводится Зритель

Обычно причина в одной из блокировок воспроизведения (строки 5–9 вFIX-01): вход и список каналов не проверяют IP / приложение, это делает только воспроизведение. Если не работает толькоодинканал на всех линиях → проблема в исходном канале; сообщите админу название канала и время.

#FIX-02
FIX-03 Пропали каналы или группы каналов Зритель

Проверьте букеты линии (PKG-04,PKG-05) и назначенный ей шаблон категорий (CAT-02). После изменения попросите клиента перезагрузить список в приложении. Канал, только что добавленный админом, появляется примерно через полминуты; если канал есть в букете, но ни одна линия его не видит, возможно, админ снял этот канал с эфира.

#FIX-03
FIX-04 Подтормаживание, зависание Зритель

Пробуйте по очереди: другой канал (один канал или все?) → другая сеть → другой формат (HLS вместо MPEG-TS) → другое приложение. Все каналы не работают в любой сети → сообщите поддержке имя пользователя, время и канал.

#FIX-04
FIX-05 Нет телепрограммы (EPG) Зритель

Для M3U-приложения нужно добавить ссылку XMLTV (PLAY-05). Канал без EPG в источнике не показывает расписание.

#FIX-05
FIX-06 Не удаётся создать линию

По порядку: пакет не выбран · пакет не предназначен для вашей группы (PKG-02) · не хватает кредитов (CRD-05) · имя пользователя занято или короче минимума (LINE-02) · квота триалов исчерпана (TRI-01).

#FIX-06
FIX-07 При скачивании плейлиста возвращается ошибка 429 или страница 404

429: линия загружает слишком много плейлистов / файлов EPG одновременно — подождите и повторите. Страница 404: система отвечает 404 налюбойотказ (неверные данные, истекла, заблокирована, превышен лимит), чтобы причина не раскрывалась посторонним; проверьте поFIX-01.

#FIX-07
FIX-08 Не открывается страница dashboard

У вашей группы нет разрешения на эту страницу (ACC-02). ДляLive Connectionsдополнительно нужно, чтобы админ включил для группы просмотр подключений клиентов (LINE-15).

#FIX-08
FIX-09 Я не получаю письма от панели

Письма отправляются, только если админ настроил почтовый сервер и включил этот тип сообщений; у аккаунта должен быть настоящий email-адрес. Проверьте папку «Спам».

#FIX-09

Глоссарий

Линия (line)
IPTV-подписка одного зрителя: имя пользователя, пароль, срок, букеты, лимиты
Пользователь (user)
аккаунт, который входит в панель: админ, реселлер, суб-реселлер
Группа
группа прав аккаунта панели; определяет меню, продаваемые пакеты, правила линий, триалы
Букет (bouquet)
список контента (каналы, фильмы, сериалы)
Пакет (package)
продаваемый продукт: букеты + срок + лимиты + цена в кредитах
Кредит
предоплаченная единица для покупки пакетов
Триал (trial)
пробный период пакета
Код активации
код, с помощью которого клиент самостоятельно активирует оплаченную линию
MAG / Enigma2
два семейства приставок; входят по MAC-адресу
Xtream Codes API
протокол, который используют большинство IPTV-приложений (сервер + имя пользователя + пароль)
M3U / XMLTV
форматы файлов плейлиста / телепрограммы
MPEG-TS / HLS
два формата потока
EPG
телепрограмма
Catch-up
просмотр передачи после её эфира
Рестример (restreamer)
линия для партнёра, который забирает потоки, чтобы распространять их дальше
Коннектор (connector)
программа, связывающая систему магазина реселлера с панелью
Вебхук (webhook)
уведомление, которое панель отправляет в систему реселлера, когда что-то происходит

Не нашли ответ?

Отправьте имя пользователя линии (никогда не пароль), время, когда это произошло, приложение или устройство и код вопроса, который вы уже пробовали.