Центр помощи
Вопросы и ответы
Как работают кредиты, пакеты, линии, ссылки для просмотра и устройства — и что проверить, если что-то не воспроизводится.
139 из 139 вопросов
Как пользоваться этой страницей
У каждого вопроса есть постоянный код (например,LINE-07). Называйте его при обращении в поддержку или скопируйте ссылку на вопрос.
Названия меню, кнопок и полей написаны так, как их показывает панель.Пользователь(user) — это аккаунт, который входит в панель (админ, реселлер);линия(line) — это IPTV-подписка зрителя. Эти понятия никогда не смешиваются.
- Зритель Реселлер может переслать этот ответ зрителю как есть
- Админ Для оператора панели
Обзор сервиса и зоны ответственности
GENGEN-01 Что предоставляет этот сервис?
Полноценную OTT / IPTV-систему: панель администратора (dashboard), API-сервер для приложений зрителей, доставку live-каналов, фильмов, сериалов и радио, а также веб-плеер. Мы предоставляем и поддерживаем систему; реселлеры используют её, чтобы давать своим клиентам право на просмотр (линии).
GEN-02 Чего сервис не делает?
- Он не собирает деньги за вас и не имеет платёжного шлюза. Цена для ваших клиентов, способ получения оплаты и выставление счетов — дело реселлера (см.CON-01).
- Он не связывается со зрителями реселлера. Панель отправляет email только аккаунтам панели, но никогда не линиям.
- Он не хранит персональные данные удалённого клиента и не имеет функции восстановления (см.DATA-01).
GEN-03 Кто есть кто в системе?
| Роль | Кто это | Где входит |
|---|---|---|
| Админ | оператор панели | dashboard |
| Реселлер | продаёт линии; получает кредиты от админа | dashboard, Reseller API |
| Суб-реселлер | реселлер, созданный ниже другого реселлера | dashboard, Reseller API |
| Линия | подписчик — конечный зритель | IPTV-приложение, приставка, веб-плеер.Никогдане dashboard |
GEN-04 Какие шаги доводят канал до зрителя?
- Админ формирует каталог (каналы, фильмы, сериалы, радио) и объединяет его вбукеты(bouquets).
- Админ создаётпакет(package): букеты + срок + число подключений + цена в кредитах.
- Реселлер тратит кредиты на продажу пакета → система создаётлинию.
- Клиент вводит данные линии в приложении; система проверяет линию (не истекла, включена, в пределах лимитов) и воспроизводит с подходящего сервера.
GEN-05 Что реселлер может делать с контентом, а что нет?
Реселлер можетпросматриватьсписки каналов, фильмов, сериалов, радио, букетов и пакетов (если у его группы есть разрешение), но не может добавлять, редактировать или удалять контент. Контентом и пакетами управляет админ. Реселлер определяет, что может смотреть каждый клиент, выбирая пакет (и букеты, если группа это позволяет —PKG-05).
GEN-06 Где получить поддержку?
ПунктSupportв боковом меню открывает отдельный сайт поддержки. Собственной тикет-системы в панели нет. Отправляя запрос, укажите: имя пользователя линии (никогда не пароль), время события, приложение / устройство и код вопроса с этой страницы, если вы уже его пробовали.
GEN-07 Какие языки есть в интерфейсе?
В панели, веб-плеере и на этой странице помощи есть переключатель языков с 27 языками. Английский и вьетнамский — эталонные переводы; на других языках только что добавленный экран может какое-то время оставаться на английском. Письма, которые отправляет панель, пока только на английском.
Аккаунты панели и вход
ACCACC-01 Почему мой клиент не может войти в dashboard?
Так задумано: линия — это не аккаунт панели. Клиент использует данные линии только в IPTV-приложении, приставке или веб-плеере. И наоборот, аккаунт реселлера нельзя использовать для просмотра каналов.
ACC-02 Я вижу меньше меню, чем описано на этой странице. Почему?
Меню и действия зависят отгруппы, которую админ назначил вашему аккаунту. Страница, на которую у вашей группы нет разрешения, не отображается в боковом меню и не открывается. Попросите админа расширить права.
ACC-03 Где сменить пароль панели?
В разделе аккаунта (профиль → смена пароля). Пароли панели хранятся в виде хеша; прочитать их не может никто — даже админ. Если вы его забыли, попросите вышестоящий аккаунт (вашего родительского реселлера или админа) задать новый.
ACC-04 Почему меня выбрасывает из аккаунта при смене сети?
Панель можно настроить так, чтобы сессия завершалась при смене IP-адреса — это не даёт использовать украденную сессию. Войдите заново. Это настройка админа.
ACC-05 Что будет после нескольких неверных попыток входа?
Панель ограничивает число неудачных входов (настраивает админ). После превышения лимита нужно подождать, прежде чем пробовать снова.
ACC-06 Чем демо-аккаунт отличается от настоящего?
Демо-аккаунт только показывает интерфейс: он не может сменить пароль, изменить профиль, создать коды активации или сделать что-либо необратимое.
ACC-07 Мой аккаунт «отключён». Что это значит?
Вышестоящий аккаунт отключил его: вы не можете войти в панель, а ваши API-ключи отклоняются. Уже проданные линии не удаляются. Свяжитесь с вышестоящим аккаунтом.
ACC-08 Где посмотреть, что делали я и мои суб-реселлеры?
Logs → Reseller Logs(если группе разрешён просмотр логов): каждая созданная, изменённая, продлённая, включённая / отключённая или удалённая линия или устройство, каждый созданный суб-реселлер и каждый перевод кредитов — со списанными кредитами. Вы видите только свои записи и записи аккаунтов ниже вас; журнал нельзя удалить (только админ). Для сверки баланса по-прежнему служит журнал кредитов (CRD).
Кредиты
CRDCRD-01 Что такое кредит?
Предоплаченная единица панели. Каждая продажа (создание линии, продление, создание кодов активации, создание суб-реселлера) списывает кредиты по цене пакета или по тарифу группы. Кредит — это не деньги, и панель их не конвертирует: сколько стоит один кредит, договариваются вы и вышестоящий аккаунт.
CRD-02 Как пополнить кредиты?
Кредиты идут сверху вниз: админ выдаёт кредиты реселлеру, реселлер переводит их суб-реселлеру. Оплата вышестоящему аккаунту происходит вне панели.
CRD-03 Чьи кредиты списываются?
Всегда кредитыаккаунта, который выполняет действие, даже если линия назначена нижестоящему суб-реселлеру.
CRD-04 Где посмотреть историю кредитов?
СтраницаCredits: одна строка на каждое движение, с датой, суммой, балансом после операции, причиной и тем, кто её выполнил. Это журнал — достоверный источник вашего баланса.
CRD-05 Что, если кредитов не хватает?
Всё действие отклоняется: линия не создаётся и ничего не списывается. Баланс никогда не уходит в минус.
CRD-06 Спишутся ли кредиты дважды, если я нажму «сохранить» два раза или пропадёт сеть?
Нет. Каждый запрос на продажу несёт идентификатор запроса (request_id); повторная отправка того же идентификатора возвращает прежний результат. Создание линии и списание кредитов всегда выполняются вместе или отменяются вместе.
CRD-07 Возвращаются ли кредиты, если я удалю линию?
CRD-08 Можно ли забрать обратно кредиты, переведённые суб-реселлеру?
Да: в форме редактирования суб-реселлера введите отрицательное число в поле перевода кредитов. Баланс не может опуститься ниже 0.
CRD-09 Как заранее узнать, сколько линий я могу купить?
Селектор пакета в форме линии показывает вашу собственную цену. Через API действиеpricingвозвращает ваш баланс, цену каждого пакета и сколько штук вы можете себе позволить.
Пакеты, букеты и цены
PKGPKG-01 Чем букет отличается от пакета?
Букет(bouquet) — это список контента (каналы, фильмы, сериалы).Пакет(package) — это продукт, который вы продаёте: один или несколько букетов, срок, число подключений, форматы вывода, блокировки и цена в кредитах (обычная цена и цена триала).
PKG-02 Почему я не вижу некоторый пакет?
Пакет могут продавать только группы, которые выбрал для него админ. Пакет, не предназначенный для вашей группы, не появляется в селекторе и отклоняется при отправке через API.
PKG-03 Моя цена отличается от цены пакета. Почему?
Админ может задатьсобственную ценудля каждого реселлера по каждому пакету (0 = бесплатно). Собственная цена применяется при создании обычной линии, продлении и обычных кодах активации; к триалам онанеприменяется.
PKG-04 Если админ меняет букеты пакета, изменятся ли уже проданные линии?
Нет. Букетыкопируются в линиюв момент продажи; последующее редактирование пакета не влияет на уже проданные линии. Новые букеты пакета линия получит при следующем продлении / смене пакета. (Когда меняется контентвнутрибукета, это сразу видят все линии с этим букетом. Удаление букета убирает его идентификатор из всех линий и пакетов. Изменение глобального порядка букетов меняет порядок, сохранённый в проданных линиях, только если вы отметите флажок «применить к проданным линиям и пакетам»; набор букетов линии при этом не меняется.)
PKG-05 Можно ли продать только часть пакета?
Только если у вашей группы включеноAllow Bouquet Selection: вы отмечаете часть букетов пакета; ничего не отмечено = весь пакет; букеты вне пакета отбрасываются. Цена не меняется.
PKG-06 Какие свойства линии определяются пакетом?
Дата окончания (сегодня + срок пакета), число подключений, форматы вывода, рестример, привязка к устройству, принудительная страна, принудительный сервер, привязка к провайдеру (ISP lock), букеты. Значения, которые реселлер вводит для этих полей, игнорируются, кроме букетов (PKG-05) и ISP lock, если у группы включеноAllow Line Restrictions.
PKG-07 Что такое пакет «MAG only» / «Enigma only»?
Пакет, который можно продать только для приставки такого типа; его нельзя продать для обычной линии или для устройства другого типа. И наоборот, чтобы использовать пакет в форме Add MAG / Add Enigma, он должен разрешать этот тип устройства.
Линии: создание, правка, продление, удаление
LINELINE-01 Что нужно для создания линии?
Нужно выбрать пакет, который ваша группа может продавать, и иметь достаточно кредитов. Имя пользователя / пароль: введите свои (если группа позволяет) или оставьте поля пустыми, чтобы они были сгенерированы. Админ при создании линии тоже может оставить одно из них (или оба) пустыми: система сгенерирует 10 символов и покажет их сразу после сохранения; формередактированияимя пользователя всё равно необходимо.
LINE-02 Почему я не могу сам выбрать имя пользователя / пароль?
У вашей группы выключеноAllow Username Change/Allow Password Change: новая линия получает сгенерированные значения. Если вы можете вводить свои, минимальную длину задаёт группа (по умолчанию 8 символов).
LINE-03 Где снова посмотреть пароль линии?
В форме редактирования линии и в диалогеGenerate play linkв списке Lines. Пароли линий хранятся в читаемом виде, потому что они нужны IPTV-приложениям и ссылкам на плейлист. Сгенерированный пароль показывается сразу после сохранения.
LINE-04 У старой линии не показан пароль, и клиент не может войти?
Некоторые линии, созданные предыдущей версией панели, хранят только хешированный пароль. Такая линияне может войти, и панель не показывает для неё пароль. Задайте новый пароль в форме редактирования линии и отправьте его клиенту.
LINE-05 Что реселлер может редактировать в линии после продажи?
Включение / отключение, заметки реселлера, контакт, шаблон категорий, владельца (в пределах вашего дерева); имя пользователя и пароль, если группа позволяет; ограничения (IP, user agent, ISP lock), если у группы включеноAllow Line Restrictions; новый выбор букетов в рамках пакета, если группа позволяет. Пакет, дату окончания, число подключений, флаг триала, форматы вывода, привязку к устройству и страну напрямуюнельзяизменить — они меняются только через продление / смену пакета.
LINE-06 Как продлить линию?
Два способа, одно правило:
- кнопкаRenew (charged)в списке: использует текущий пакет линии;
- полеExtend with packageв форме редактирования: выберите любой пакет, который вы можете продавать (так же выполняетсясмена пакета).
Если вы редактируете линию и выбираете продление в одном сохранении, обе операции —одна транзакция: если продление отклонено (не хватает кредитов, пакет нельзя продавать), правка тоженесохраняется и кредиты не списываются. Исправьте и сохраните снова.
LINE-07 Сохраняется ли оставшееся время при продлении?
- Линияне истекла, а новый пакетсовместимсо старым → время добавляется к текущей дате окончания.
- Линияистеклаили пакеты несовместимы → отсчёт ведётся от сегодняшнего дня; остаток времени не сохраняется.
«Совместимость» проверяется, только если у нового пакета включена опция проверки совместимости: у обоих пакетов должны совпадать букеты, форматы вывода, число подключений, флаг рестримера и привязка к устройству. При выключенной опции пакеты всегда считаются совместимыми. У новых пакетов опция включена по умолчанию (админ может её выключить); у существующих пакетов настройка сохраняется. Линию MAG / Enigma можно продлить или перевести только на пакет, который допускает такой тип приставки.
LINE-08 Как тарифицируется смена пакета (апгрейд / даунгрейд)?
Смена пакета = покупка одного обычного периода нового пакета: списывается полная цена нового пакета (ваша собственная цена, если она есть), без зачёта неиспользованной части. Линия получает все свойства нового пакета.
LINE-09 Чем отключение линии отличается от удаления?
Отключение: клиент не может войти и смотреть, текущие сессии закрываются примерно в течение минуты; срок подписки продолжает идти; вы можете включить линию снова в любой момент.Удаление: безвозвратно, без восстановления и без возврата кредитов (DATA-01). Если клиент делает паузу — отключайте, не удаляйте.
LINE-10 Что означают статусы линии?
| Статус | Значение | Кто может снять |
|---|---|---|
| Active | можно использовать | — |
| Disabled | отключена реселлером / владельцем | реселлер |
| Banned | заблокирована админом | только админ |
| Expired | прошла дата окончания | продление |
| Trial | пробная линия, доступна до конца пробного периода | становится обычной при продлении |
LINE-11 Что происходит, когда линия истекает?
Клиенту отказывают до продления линии (линия, которая одновременно истекла и забанена, видит ролик «истекла», потому что срок проверяется первым); текущие сессии закрываются примерно в течение минуты. Линиянеудаляется автоматически: продлите её, и она снова заработает с теми же именем пользователя / паролем.
LINE-12 Можно ли передать линию суб-реселлеру?
Да: выберите владельцем аккаунт ниже вас. Владелец видит линию в своём списке. Кредиты по-прежнему списываются с того, кто нажимает «сохранить».
LINE-13 Чьи линии я вижу?
Свои и линии всех аккаунтов ниже вас. Линия вне вашего дерева для вас не существует (ответ — «не найдено»).
LINE-14 Для чего нужны поля «Contact» и «Reseller notes»?
Чтобы вы помнили, кто этот клиент (email, телефон, номер заказа). Подписчик их никогда не видит. Они безвозвратно стираются при удалении линии.
LINE-15 Можно ли увидеть, что смотрит линия и откуда?
Если у группы есть разрешение:Logs → Line Activityпоказывает историю просмотров каждой линии, аLogs → Live Connections— все открытые подключения линий в вашем дереве (какая линия, какой канал, с какого адреса) с кнопкой для их закрытия. Live Connections открывается, только если админ включил для вашей группы просмотр истории подключений клиентов (флажокclient connection logsв форме группы); подключения линий вне вашего дерева вы не видите никогда.
LINE-16 Почему в списке Lines нет линий кодов активации?
LINE-17 Включает ли дата окончания в форме линии время? Админ
Да. ПолеExpires onв форме линии — это датаи времяв часовом поясе панели, поэтому линия может истекать в определённый час. Если открыть форму и сохранить, не трогая это поле, срок сохраняется с точностью до секунды — правка заметки или букетов не даёт почасовой пробной линии дополнительного времени. Значение, которое не удаётся прочитать, помечается ошибкой у самого поля и никогда не превращается в «бессрочно». Страница массового редактирования по-прежнему принимает дату, которая читается как конец этого дня.
Триалы
TRITRI-01 Когда я могу создать пробную линию?
Когда выполняетсявсёперечисленное: админ не отключил триалы для реселлеров; у пакета есть пробный период; у вашей группыAllowed Trials> 0; ваши кредиты ≥Minimum Trial Creditsгруппы; а число пробных линий, созданных вами за расчётный период, не достигло квоты.
TRI-02 За какой период считается квота триалов?
Как задано в группе:день= последние 24 часа,месяц= последние 30 дней. Пример, квота 5 / день: не более 5 пробных линий за любые 24 часа. Более старый триал освобождает слот, когда выходит за пределы периода.
TRI-03 Стоит ли триал кредитов?
Ровно цену триала пакета (обычно 0). Собственная цена реселлера к триалам не применяется.
TRI-04 Почему флажок триала заблокирован?
TRI-05 Как превратить триал в обычную линию?
Продлите линию с пакетом: линия получает обычный период и перестаёт быть триалом. Имя пользователя и пароль остаются прежними, клиенту не нужно ничего настраивать заново.
Ссылки для просмотра, приложения и форматы
PLAYPLAY-01 Где взять ссылку для моего клиента?
Lines → Generate play link: выберите формат; ссылка строится с именем пользователя и паролем линии. Через APIget_lineвозвращает готовые ссылки:m3u,m3u_hls,xmltv,player_api,web_player.
PLAY-02 Какие приложения может использовать клиент? Зритель
Любое приложение с поддержкойXtream Codes API(IPTV Smarters, TiviMate, XCIPTV, GSE…): введите адрес сервера + имя пользователя + пароль. Для приложения, принимающего только плейлист, используйте ссылкуM3U. ПриставкиMAGиспользуют портал, приставкиEnigma2— плейлист / плагин. Без какого-либо устройства используйтевеб-плеерв браузере.
PLAY-03 MPEG-TS или HLS?
MPEG-TS: быстрое переключение каналов, подходит для IPTV-приложений и приставок.HLS: хорошо работает в браузерах, на устройствах Apple и в нестабильных сетях. Линия может использовать только форматы, которые разрешает её пакет; ссылка в неразрешённом формате отклоняется.
PLAY-04 Какие бывают типы плейлистов?
m3u_plus(с логотипами, группами, EPG-идентификаторами — рекомендуемый вариант по умолчанию), простойm3u, типы для Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive и простые списочные типы. Выберите нужный в диалоге Generate play link.
PLAY-05 Откуда берётся телепрограмма (EPG)? Зритель
Xtream-приложения получают её сами. Для M3U-приложения используйте ссылкуXMLTVлинии (плейлистm3u_plusуже содержит адрес EPG).
PLAY-06 Есть ли catch-up? Зритель
Да, на каналах, для которых админ включил архив; приложения показывают значок catch-up на таких каналах.
PLAY-07 Где веб-плеер и как в него войти? Зритель
По адресу/player/на API-сервере (ссылкаweb_player). Входите с именем пользователя / паролем линии или с кодом активации.
PLAY-08 Работает ли старая ссылка после смены пароля линии?
Нет. Пароль входит в ссылку и сохранён в приложении; после смены пароля клиенту нужно ввести его заново / получить новую ссылку. Так же можно отключить того, кто пользуется линией без разрешения.
PLAY-09 Можно ли использовать собственный домен для ссылок для просмотра?
Да: задайтеYour own play addressна странице API-ключа (или через API-действиеset_play_base). Вы направляете DNS домена на API-сервер панели,иоператор должен настроить свою сторону; сообщите админу, прежде чем использовать это. Адрес применяется к ссылкам, которые API возвращает вашей системе.
Приставки MAG / Enigma2
DEVDEV-01 Как добавить приставку MAG / Enigma?
Devices → Add MAG / Add Enigma: введите MAC, выберите пакет. Система продаёт новую линию и привязывает устройство за один шаг; устройство входит по своему MAC, имя пользователя / пароль вводить никому не нужно. Кредиты списываются так же, как для обычной линии.
DEV-02 У клиента уже есть линия, и он хочет добавить приставку?
В форме устройства выберитесуществующую линиюклиента вместо пакета: устройствосвязываетсяс этой линией бесплатно. Клиент продолжает пользоваться линией в приложении; приставка следует за пакетом, сроком, букетами и статусом линии.
DEV-03 Как считаются подключения для связанных приложения и приставки?
Ониделятлимит подключений: приложение и приставка — один подписчик.
DEV-04 Как продлить приставку?
Продлите её линию (ссылка есть в форме устройства). Для связанного устройства продлите линию клиента — приставка последует за ней сама.
DEV-05 Клиент заменяет приставку на новую?
Измените MAC в устройстве. Если у линии включена привязка к устройству, сбросьте записанный серийный номер / идентификатор устройства, чтобы новая приставка могла зарегистрироваться.
DEV-06 Удаляется ли линия при удалении устройства?
Да. Удаление устройства удаляет и его линию (вместе с историей подключений и ожидающими событиями), как в старой панели. Чтобы сохранить оплаченную линию, используйте кнопкуConvert to line: устройство удаляется, а линия становится обычной. Когда вы удаляете линию клиента, связанное устройство продолжает жить самостоятельно со своей линией.
DEV-07 Может ли реселлер управлять приставкой удалённо?
Своими приставкамиMAG— да: отправить сообщение на ТВ, запустить канал, перезагрузить портал, перезагрузить устройство, закрыть подключения линии (группе нужно разрешение на просмотр логов подключений клиентов), сбросить записанного провайдера (ISP) и сбросить блокировку STB. Команды X-Plugin и скриншоты приставокEnigma, бан устройства и перенос устройства на другую линию доступны только админу. Включение / отключение устройства реселлера включает / отключает его линию; реселлер не может снятьBannedс устройства.
Коды активации
CODECODE-01 Для чего нужен код активации?
Продажа доступа в виде кода (скретч-карта, код, отправленный сообщением): клиент вводит код в приложении или в веб-плеере и может смотреть без имени пользователя / пароля. Срокначинается только тогда, когда клиент впервые активирует код.
CODE-02 Как создавать коды и сколько они стоят?
Active Codes → New: выберите пакет, количество (1–500 в одной партии), длину кода (6–24), вариант «только цифры» (удобно вводить пультом ТВ), вариант триала. Кредиты списываютсяпри создании= цена пакета × число кодов. К каждому коду прилагается своя линия, заблокированная до активации.
CODE-03 Какие символы содержит код?
Заглавные буквы и цифры без легко путаемых символов (0, O, 1, I) либо только цифры. Если клиент вводит строчные буквы, код всё равно принимается.
CODE-04 На скольких устройствах можно использовать один код? Зритель
На одном. Код привязывается к первому устройству, которое его активирует; другое устройство, вводящее тот же код, получает отказ. Это устройство может вводить код сколько угодно раз, данные входа линии при этом не меняются.
CODE-05 Что делать, если клиент сменил устройство?
ВыполнитеReset deviceдля этого кода; после этого новое устройство сможет его активировать. Время к сроку не добавляется.
CODE-06 Клиент получает ошибку при вводе кода. Что она означает? Зритель
| Сообщение | Значение | Что делать |
|---|---|---|
INVALID_CODE | неверный код / кода не существует | проверьте каждый символ; не вводите дефисы |
DEVICE_MISMATCH | код привязан к другому устройству | реселлер сбрасывает устройство (CODE-05) |
DISABLED | код отключён | реселлер включает его снова |
EXPIRED | срок закончился | купить код / продлить |
Если подряд ввести несколько разных неверных кодов, IP-адрес на некоторое время блокируется (SEC-08).
CODE-07 Как продлить активированный код?
На страницеActive Codesотметьте код, выберите действиеExtend (days)и введите число дней. Дни добавляются толькоактивированномукоду (у неиспользованного срок ещё не начался); действующий код продлевается от текущей даты окончания, истёкший — от текущего момента. Это действие не списывает кредиты. Через API:extend_active_code.
CODE-08 Возвращаются ли кредиты при удалении кода?
Неиспользованныйкод, созданный реселлером: возврат полностью, с записью в журнале кредитов.Активированныйкод: без возврата.
CODE-09 Как управлять сразу многими кодами?
СтраницаBatchesпоказывает по каждой партии всего / готовых / активированных / отключённых и экспортирует TXT-файл (один код на строку). Массовые действия: включить, отключить, сбросить устройство, удалить.
CODE-10 Соблюдает ли линия кода активации лимиты пакета?
Да, как и любая линия, проданная с этим пакетом: число подключений, форматы вывода, букеты, привязка к устройству, рестример, а такжепринудительная странапакета (SEC-07). Клиент, который активирует код из страны вне списка разрешённых, сможет его активировать, но получит отказ при воспроизведении.
Лимиты подключений и блокировки, защищающие линию
SECSEC-01 Как считается «Max connections»?
Это число устройств, которые смотрятодновременнос одной линии. 0 = без ограничений. Повторное открытие канала, который вы уже смотрите, с того же устройства не считается новым подключением.
SEC-02 Кого отключают при превышении лимита? Зритель
По умолчанию:новоеподключение проходит, асамое староезакрывается (предпочтение отдаётся подключению с того же устройства, затем с того же IP). Закрытый плеер останавливается примерно через 30 секунд. Админ может переключить поведение наотказ новому подключениювместо закрытия старого.
SEC-03 Что такое правило «второго IP»?
Когда админ его включил: пока линию смотрят с одного IP, live-подключение с другого IP отклоняется. Правило можно ограничить линиями с малым числом подключений (например, линиями с 1 подключением; линия с неограниченным числом подключений привязывается только при пороге 0). При включённомMatch The Address By Networkадреса одной сети /24 (IPv6: /64) считаются одним зрителем. Это средство против передачи аккаунта другим.
SEC-04 Можно ли ограничить линию определёнными IP или приложениями?
Если у группы включеноAllow Line Restrictions: полеAllowed IPs(IP, диапазон CIDR или доменное имя, по одному в строке; домен разрешается в момент подключения, поэтому динамический IP тоже работает) иAllowed User-Agents. Пусто = разрешено всё. Учтите: эти ограничения блокируютвоспроизведение; приложение по-прежнему входит и показывает список каналов.
SEC-05 Что такое ISP lock?
Линия запоминает интернет-провайдера первого подключения и отказывает в использовании у другого провайдера. Когда клиент меняет провайдера, выключите и снова включите ISP lock, чтобы записать нового. На приставки MAG это не распространяется.
SEC-06 Что такое привязка к устройству (device lock)?
Она привязывает линию к первой приставке, которая вошла (серийный номер, идентификатор устройства); другая приставка получает отказ. Определяется пакетом.
SEC-07 Как работает ограничение по стране?
Линия может подключаться только из своей принудительной страны (ALL= откуда угодно). Если оно пусто, действует общий список разрешённых стран панели. Клиент, который путешествует за границей или использует VPN, может получить отказ по этой причине.
SEC-08 Почему IP-адрес заблокирован? Зритель
- Автоматически: неудачные входы с одного IP под множеством разных имён пользователей / кодов активации за короткое время или поток запросов. Автоматическая блокировка снимается сама через время, заданное админом (по умолчанию 60 минут).
- Вручную: админ заблокировал IP / диапазон IP; такая блокировка не истекает.
Пока IP заблокирован,ни одналиния не может подключиться с него. Многократная опечатка в одном и том же имени пользователя блокировку не вызывает.
SEC-09 По каким ещё причинам подключение может быть заблокировано?
Админ может блокировать поUser-Agent(приложению), поинтернет-провайдеру (ISP)и поASN(например, диапазоны хостингов / VPN). Линия, для которой админ включил «bypass UA», пропускает список блокировки приложений.
SEC-10 Что такое рестример?
Линия для партнёра, который забирает потоки, чтобы распространять их дальше. На неё не действуют лимит подключений, правило второго IP, автоматическое завершение долгих сессий и блокировка по ASN. Определяется пакетом / админом; не предназначена для обычных зрителей.
SEC-11 Обрывается ли очень длинная непрерывная сессия? Зритель
Админ может задать максимальную длительность непрерывной сессии; после неё сессия закрывается, и клиенту нужно нажать play, чтобы продолжить. Сессия, потерявшая сигнал примерно на 90 секунд, тоже считается закрытой.
SEC-12 Как обнаружить линию, которой делятся или которую украли?
- СтраницаTheft Detection(если у группы есть разрешение): ранжирует линии по числуразныхфильмов / серий, просмотренных за 1 час / 24 часа / 7 дней, с числом разных IP — необычно высокий показатель вызывает подозрение.
- Страница активности линии: показывает используемые IP и устройства.
- Что делать: сменить пароль линии (PLAY-08), включить ограничение по IP / ISP lock или отключить линию.
Суб-реселлеры
SUBSUB-01 Могу ли я создавать суб-реселлеров?
Если у вашей группы включеноCan Create Sub-Resellersи есть хотя бы одна группа вGroups for sub-resellers. Каждое создание списывает плату за создание (в кредитах), заданную в группе. Дерево реселлеров имеет не более 5 уровней.
SUB-02 К какой группе относится суб-реселлер и что он может делать?
Вы выбираете группу из списка, который разрешает админ; эта группа определяет права суб-реселлера, продаваемые пакеты и квоту триалов.
SUB-03 Чем я могу управлять у суб-реселлера?
Email, имя, пароль, статус, группа (из списка), заметки, перевод / возврат кредитов и все линии под ним. Менять его роль или владельца нельзя.
SUB-04 Что суб-реселлер видит из моего?
Ничего: каждый аккаунт видит только то, что находится ниже него, но никогда вышестоящие уровни или другие ветви.
SUB-05 Куда уходят линии и кредиты суб-реселлера, когда я его удаляю?
У группы должно быть включеноCan Delete Users. Оставшиеся кредиты, линии и дочерние аккаунты переходят каккаунту, который удаляет. Линии клиентов продолжают работать. Персональные данные удалённого аккаунта (имя пользователя, email, имя, пароль, API-ключи, заметки) стираются; это имя пользователя и email можно использовать снова.
SUB-06 Получает ли новый суб-реселлер письмо?
Если админ включил приветственное письмо: новый аккаунт получает имя для входа и ссылку для входа. В письменикогданет пароля — пароль вы отправляете сами.
Шаблоны категорий
CATCAT-01 Для чего нужен шаблон категорий?
Чтобы менять порядок, переименовывать или скрывать категории (live, фильмы, сериалы, радио), которые клиент видит в приложении, — для каждой линии отдельно, не затрагивая собственные категории панели.
CAT-02 Что происходит, когда я скрываю категорию?
Весь контент этой категории тоже скрывается из приложения и плейлиста линий, использующих шаблон.
CAT-03 Если я изменю шаблон, изменятся ли использующие его линии?
Да, сразу для каждой линии, которой назначен шаблон. Когда шаблон удаляется, его линии возвращаются к раскладке по умолчанию.
CAT-04 Какие шаблоны я могу видеть и редактировать?
Видеть: свои и шаблоны аккаунтов ниже вас, системные шаблоны и шаблоны, которыми поделились вышестоящие уровни. Редактировать: только свои и шаблоны ниже вас. Чтобы изменить системный шаблон,продублируйтеего и отредактируйте копию.
CAT-05 Какие ограничения стоит знать?
Пользовательский порядок категорий не применяется к части с фильмами / сериалами в M3U-плейлисте (названия и скрытие по-прежнему действуют). Приложения, использующие Xtream API, получают всё.
Reseller API, API-ключи, вебхуки
APIAPI-01 Для чего нужен Reseller API?
Чтобы ваша собственная система (веб-магазин, биллинг, бот) продавала и управляла линиями / суб-реселлерами, не открывая dashboard. Адрес:{API}/reseller/v1, аутентификация заголовкомX-API-Key. Полная документация находится по адресу/docs/на API-сервере.
API-02 Где получить API-ключ?
СтраницаAPI Key. Ключ показываетсяодин раз, при создании — скопируйте его сразу. Если вы его потеряли, создайте новый ключ (старый перестанет работать).
API-03 Нужно ли использовать один ключ для всех систем?
Лучше нет. Создавайтедополнительный ключдля каждой системы: дайте ему имя, ограничьте IP / CIDR, которым разрешено его использовать, при желании сделайте еготолько для чтения(только списки и просмотр) и отзывайте его отдельно, не затрагивая другие ключи.
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 |
| Коды активации | создание, список, включение / отключение, сброс устройства, удаление |
| Вебхуки, собственный адрес воспроизведения, журнал вызовов API | create_webhook…,set_play_base,api_logs |
Каждое правило dashboard (группа, собственная цена, квота триалов, область дерева) действует через API точно так же.
API-05 Если я повторю запрос после сетевой ошибки, спишутся ли кредиты дважды?
Нет, если вы отправляете тот жеrequest_idдля той же транзакции: система возвращает прежний результат.request_idпродленияпривязан к этой линии: его повторное использование для другой линии возвращает ошибку конфликта (HTTP 409), и другая линия не меняется — генерируйте новыйrequest_idдля каждой транзакции.
API-06 Моя интеграция не работает. Как проверить самому?
На странице API Key есть таблицапоследних вызовов API(30 дней): действие, результат, код ошибки, адрес вызывающего, имя коннектора. Параметры никогда не записываются.
API-07 Что такое вебхук и какие бывают события?
Панель сообщает вашей системе, когда что-то происходит, чтобы вам не приходилось постоянно спрашивать. События:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(за 3 дня),line.expired,credits.low(ниже заданного вами порога). Принимающий адрес должен быть https и доступен из интернета.
API-08 Как понять, что вебхук подлинный?
Каждое уведомление несёт подписьX-Xtream-Signature: sha256=HMAC(secret, timestamp.body); секрет показывается один раз, при создании endpoint. Вебхук никогда не содержит пароль.
API-09 Вебхук перестал отправлять?
Каждое уведомление пробуется 3 раза; endpoint, у которого 20 доставок подряд завершились неудачей, отключается. Исправьте проблему на своей стороне, используйтеSend test, затем создайте endpoint заново, если он был отключён.
API-10 Возвращает ли API пароли линий?
Да, но только владельцу линии (вам и вышестоящим уровням в дереве). Не сохраняйте пароли линий в логах и не отправляйте их по небезопасному каналу.
API-11 Может ли `edit_line` продлить линию?
Да, если вместе с ним отправитьpackage_id(старое имяpackageтоже принимается): помимо правки, действие продаёт один обычный период этого пакета точно так же, какchange_package— та же цена, тот жеrequest_id, а в ответе естьcredits_charged. Правка и продление — одна транзакция: если она отклонена (не хватает кредитов, неверный пакет, переданtrial), ничего не меняется.edit_lineбезпакета правит только имя пользователя, пароль, контакт и заметки и не трогает пакет и срок.
API-12 Будет ли работать с этим API скрипт, написанный для старой (PHP) панели?
Не как есть. API сохраняет привычные имена действий, но это новый интерфейс: адрес/reseller/v1, API-ключ, созданный в этой панели, действия записи отправляются через POST, ошибки возвращаются как HTTP-статус с полемerror, а результат создания линии находится вdata.line. Используйте документацию по адресу/docs/или готовый коннектор (CON-02).
Коннекторы для магазинов и биллинговых систем
CONCON-01 Как собирать деньги с моих клиентов?
С помощьювашей собственнойсистемы и платёжного шлюза. Панель не обрабатывает платежи. Коннектор связывает вашу систему магазина с панелью: клиент платит на вашей стороне → коннектор вызывает Reseller API, чтобы создать / продлить линию.
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-03 Где скачать и как установить?
Боковое менюResources → All Connectors: у каждого коннектора есть описание, данные для подключения, шаги установки, кнопкаDownloadи SHA-256 файла для проверки.
CON-04 Насколько протестированы коннекторы?
По-разному для каждого коннектора, и страница каждого из них об этом сообщает: одни запускались внутри настоящей платформы (например, WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), у других проверялось только ядро. Прочитайте строку «как это тестировалось» и испытайте коннектор в тестовой среде, прежде чем продавать по-настоящему.
CON-05 Безопасен ли коннектор и что он делает с панелью?
CON-06 Что может продавать коннектор?
Линии (создание, продление, смена пакета, приостановка, удаление) и аккаунты суб-реселлеров с кредитами.
Данные, удаление и конфиденциальность
DATADATA-01 Можно ли восстановить удалённую линию?
Нет. Удалено — значит исчезло: данные линии (имя пользователя, пароль, контакт, заметки), история её подключений (IP, устройства, что смотрели), приставки, привязанные к линии, и её код активации. Корзины, функции или API восстановления нет. Когда клиент вернётся, создайте новую линию.
DATA-02 Что система хранит после удаления?
Толькоанонимнуюстатистическую запись для оператора (новый или вернувшийся клиент, какие пакеты популярны). В ней нет ничего читаемого о клиенте, и ни один реселлер, коннектор или API не может до неё добраться.
DATA-03 Может ли резервная копия вернуть удалённую линию?
Нет. Резервные копии базы данных существуют только для восстановления системы после инцидента и хранятся у оператора; они не используются для отмены удаления. Старые копии ротируются, поэтому удалённые данные исчезают и из них.
DATA-04 Почему пароль линии читаем, а пароль панели нет?
Пароль линии нужно вводить в приложениях, и он входит в ссылку на плейлист, поэтому панель хранит его в читаемом виде для владельца линии. Пароли аккаунтов панели хранятся только в виде хеша.
DATA-05 Кто может видеть мои линии и клиентов?
Вы, вышестоящие аккаунты в вашем дереве и админ. Другие реселлеры и уровни ниже вас — не могут.
DATA-06 Отправляет ли панель email / сообщения моим клиентам?
Никогда. Клиенты линии принадлежат реселлеру; вы связываетесь с ними через собственную систему.
DATA-07 Предупредят ли меня до истечения линии?
Двумя способами: ежедневное сводное письмо о линиях, срок которых скоро истекает (если админ его включил; по умолчанию за 3 дня), и вебхукиline.expiring/line.expiredдля вашей системы.
Устранение неполадок
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: дождитесь снятия блокировки или попросите админа снять её |
| 7 | ISP lock / страна / Allowed IPs | сбой только после смены сети, на мобильном интернете, с VPN или в поездке | SEC-04,SEC-05,SEC-07 |
| 8 | Формат | ссылка HLS / TS отклоняется | используйте формат, который разрешает пакет (PLAY-03) |
| 9 | Заблокированное приложение | сбой только в одном приложении | попробуйте другое приложение;SEC-09 |
FIX-02 Вход работает и список показывается, но канал не воспроизводится Зритель
FIX-03 Пропали каналы или группы каналов Зритель
Проверьте букеты линии (PKG-04,PKG-05) и назначенный ей шаблон категорий (CAT-02). После изменения попросите клиента перезагрузить список в приложении. Канал, только что добавленный админом, появляется примерно через полминуты; если канал есть в букете, но ни одна линия его не видит, возможно, админ снял этот канал с эфира.
FIX-04 Подтормаживание, зависание Зритель
Пробуйте по очереди: другой канал (один канал или все?) → другая сеть → другой формат (HLS вместо MPEG-TS) → другое приложение. Все каналы не работают в любой сети → сообщите поддержке имя пользователя, время и канал.
FIX-05 Нет телепрограммы (EPG) Зритель
FIX-06 Не удаётся создать линию
FIX-07 При скачивании плейлиста возвращается ошибка 429 или страница 404
FIX-08 Не открывается страница dashboard
FIX-09 Я не получаю письма от панели
Письма отправляются, только если админ настроил почтовый сервер и включил этот тип сообщений; у аккаунта должен быть настоящий email-адрес. Проверьте папку «Спам».
Глоссарий
- Линия (line)
- IPTV-подписка одного зрителя: имя пользователя, пароль, срок, букеты, лимиты
- Пользователь (user)
- аккаунт, который входит в панель: админ, реселлер, суб-реселлер
- Группа
- группа прав аккаунта панели; определяет меню, продаваемые пакеты, правила линий, триалы
- Букет (bouquet)
- список контента (каналы, фильмы, сериалы)
- Пакет (package)
- продаваемый продукт: букеты + срок + лимиты + цена в кредитах
- Кредит
- предоплаченная единица для покупки пакетов
- Триал (trial)
- пробный период пакета
- Код активации
- код, с помощью которого клиент самостоятельно активирует оплаченную линию
- MAG / Enigma2
- два семейства приставок; входят по MAC-адресу
- Xtream Codes API
- протокол, который используют большинство IPTV-приложений (сервер + имя пользователя + пароль)
- M3U / XMLTV
- форматы файлов плейлиста / телепрограммы
- MPEG-TS / HLS
- два формата потока
- EPG
- телепрограмма
- Catch-up
- просмотр передачи после её эфира
- Рестример (restreamer)
- линия для партнёра, который забирает потоки, чтобы распространять их дальше
- Коннектор (connector)
- программа, связывающая систему магазина реселлера с панелью
- Вебхук (webhook)
- уведомление, которое панель отправляет в систему реселлера, когда что-то происходит
Подходящих вопросов нет
Попробуйте другое ключевое слово или код вопроса либо сбросьте фильтр.
Не нашли ответ?
Отправьте имя пользователя линии (никогда не пароль), время, когда это произошло, приложение или устройство и код вопроса, который вы уже пробовали.