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

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

• Он не собирает деньги за вас и не имеет платёжного шлюза. Цена для ваших клиентов, способ получения оплаты и выставление счетов — дело реселлера (см. CON-01).
• Он не связывается со зрителями реселлера. Панель отправляет email только аккаунтам панели, но никогда не линиям.
• Он не хранит персональные данные удалённого клиента и не имеет функции восстановления (см. DATA-01).

1. Админ формирует каталог (каналы, фильмы, сериалы, радио) и объединяет его в букеты (bouquets).
2. Админ создаёт пакет (package): букеты + срок + число подключений + цена в кредитах.
3. Реселлер тратит кредиты на продажу пакета → система создаёт линию.
4. Клиент вводит данные линии в приложении; система проверяет линию (не истекла, включена, в пределах лимитов) и воспроизводит с подходящего сервера.

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

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

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

Установочные пакеты, их контрольные суммы SHA-256 и полное руководство по установке (на английском) находятся на https://download.xtream-ui.pro.

• Вам понадобится: Ubuntu 22.04 или 24.04 (виртуальная машина или физический сервер), root или sudo, лучше всего чистый сервер.
• Установка: скачайте пакет для вашего процессора прямо на сервер, проверьте его командой sha256sum, распакуйте и выполните sudo ./install.sh.
• Обновление работающего сервера: sudo ./upgrade.sh --tag <version>.

Домены с TLS, edge-узлы и все опции описаны в руководстве.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

В панели: боковое меню Ресурсы → Все коннекторы — каждый коннектор с данными подключения, шагами установки, кнопкой Скачать и SHA-256 файла для проверки.

Те же коннекторы, с шагами установки и контрольными суммами, опубликованы на https://plugins.xtream-ui.pro; исходный код находится на https://github.com/xtreamui-pro/plugins.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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