Perguntas e respostas

Um sistema OTT / IPTV completo: o painel de administração (dashboard), o servidor de API para as aplicações dos espectadores, a distribuição de canais em direto, filmes, séries e rádio, e um web player. Nós fornecemos e mantemos o sistema; os revendedores usam-no para dar aos seus clientes o direito de ver (linhas).

• Não cobra dinheiro por si e não tem gateway de pagamento. O preço para os seus clientes, a forma como recebe e a faturação são assunto do revendedor (ver CON-01).
• Não contacta os espectadores de um revendedor. O painel só envia e-mail a contas do painel, nunca a uma linha.
• Não guarda dados pessoais de um cliente eliminado e não tem função de restauro (ver DATA-01).

1. O admin constrói o catálogo (canais, filmes, séries, rádio) e agrupa-o em bouquets.
2. O admin cria um package: bouquets + duração + número de ligações + preço em créditos.
3. Um revendedor gasta créditos para vender o pacote → o sistema cria uma linha.
4. O cliente introduz os dados da linha numa aplicação; o sistema verifica a linha (não expirada, ativa, dentro dos seus limites) e reproduz a partir de um servidor adequado.

Um revendedor pode ver as listas de canais, filmes, séries, rádio, bouquets e pacotes (quando o seu grupo tem a permissão), mas não pode adicionar, editar nem eliminar conteúdo. O conteúdo e os pacotes são geridos pelo admin. Um revendedor decide o que cada cliente pode ver escolhendo o pacote (e os bouquets, quando o grupo o permite — PKG-05).

A entrada Support da barra lateral abre o site de suporte separado. O painel não tem um sistema de tickets próprio. Ao enviar um pedido, inclua: o nome de utilizador da linha (nunca a palavra-passe), quando aconteceu, a aplicação / dispositivo e o código da pergunta desta página, se já a experimentou.

O painel, o web player e esta página de ajuda têm um seletor de idioma com 27 idiomas. O inglês e o vietnamita são as traduções de referência; nos outros idiomas, um ecrã recém-adicionado pode ficar em inglês durante algum tempo. O e-mail enviado pelo painel está atualmente apenas em inglês.

Os pacotes de instalação, as suas somas de verificação SHA-256 e o guia de instalação completo (em inglês) estão em https://download.xtream-ui.pro.

• Precisa de: Ubuntu 22.04 ou 24.04 (máquina virtual ou bare metal), root ou sudo, de preferência um servidor novo.
• Instalar: transfira o pacote para o seu CPU diretamente no servidor, verifique-o com sha256sum, descompacte-o e execute sudo ./install.sh.
• Atualizar um servidor em funcionamento: sudo ./upgrade.sh --tag <version>.

Os domínios com TLS, os nós de borda e todas as opções são explicados no guia.

É intencional: uma linha não é uma conta do painel. Um cliente só usa os dados da linha numa aplicação IPTV, numa set-top box ou no web player. Da mesma forma, uma conta de revendedor não pode ser usada para ver canais.

Os menus e as ações dependem do grupo que o admin atribuiu à sua conta. Uma página para a qual o seu grupo não tem permissão não é mostrada na barra lateral e não pode ser aberta. Peça mais permissões ao admin.

Na área da conta (perfil → alterar palavra-passe). As palavras-passe do painel são guardadas com hash; ninguém as pode voltar a ler — nem mesmo o admin. Se a esquecer, peça à conta acima da sua (o seu revendedor principal ou o admin) que defina uma nova.

O painel pode ser configurado para terminar uma sessão quando o seu endereço IP muda, para que uma sessão roubada não possa ser reutilizada. Inicie sessão novamente. É uma definição do admin.

O painel limita os inícios de sessão falhados (configurado pelo admin). Depois do limite, tem de esperar antes de tentar novamente.

Uma conta demo apenas mostra a interface: não pode alterar a palavra-passe, editar o perfil, criar códigos de ativação nem fazer nada que não possa ser desfeito.

A conta acima da sua desligou-a: não pode iniciar sessão no painel e as suas chaves de API são recusadas. As linhas já vendidas não são eliminadas. Contacte a conta acima da sua.

Logs → Reseller Logs (quando o grupo pode ver logs): cada linha ou dispositivo criado, editado, renovado, ativado / desativado ou eliminado, cada subrevendedor criado e cada transferência de créditos — com os créditos cobrados. Só vê as suas próprias entradas e as das contas abaixo da sua; o log não pode ser eliminado (apenas pelo admin). O livro de créditos (CRD) continua a ser o local para reconciliar um saldo.

A unidade pré-paga do painel. Cada venda (criar uma linha, renovar, criar códigos de ativação, criar um subrevendedor) consome créditos de acordo com o preço do pacote ou a taxa do grupo. Um crédito não é dinheiro e o painel não o converte: quanto vale um crédito é combinado entre si e a conta acima da sua.

Os créditos fluem de cima para baixo: o admin dá créditos a um revendedor, um revendedor transfere-os para um subrevendedor. O pagamento à conta acima da sua é feito fora do painel.

Sempre os da conta que executa a ação, mesmo quando a linha é atribuída a um subrevendedor abaixo.

A página Credits: uma linha por movimento, com a data, o montante, o saldo depois, o motivo e quem o fez. Este é o livro de registo — a fonte de referência do seu saldo.

A ação inteira é recusada: nenhuma linha é criada e nada é cobrado. Um saldo nunca fica negativo.

Não. Cada pedido de venda leva um id de pedido (request_id); enviar o mesmo id novamente devolve o resultado anterior. Criar a linha e cobrar os créditos têm sempre êxito em conjunto ou são cancelados em conjunto.

Não. Eliminar uma linha não reembolsa nada, mesmo que tenha tempo restante. A única exceção: eliminar um código de ativação não utilizado que o revendedor criou é reembolsado (CODE-08).

Sim: no formulário de edição do subrevendedor, introduza um número negativo no campo de transferência de créditos. Nenhum saldo pode ficar abaixo de 0.

O seletor de pacote do formulário de linha mostra o seu preço. Através da API, a ação pricing devolve o seu saldo, o preço de cada pacote e quantos pode comprar.

Um bouquet é uma lista de conteúdo (canais, filmes, séries). Um package é o produto que vende: um ou mais bouquets, uma duração, um número de ligações, formatos de saída, bloqueios e um preço em créditos (preço oficial e preço de teste).

Um pacote só pode ser vendido pelos grupos que o admin selecionou para ele. Um pacote que não se destina ao seu grupo não aparece no seletor e é recusado quando enviado através da API.

O admin pode definir um preço próprio por revendedor para cada pacote (0 = grátis). O preço próprio aplica-se à criação de uma linha oficial, à renovação e aos códigos de ativação oficiais; não se aplica aos testes.

Não. Os bouquets são copiados para a linha no momento da venda; editar o pacote depois não afeta as linhas já vendidas. Uma linha recebe os novos bouquets do pacote na sua próxima renovação / mudança de pacote. (Quando o conteúdo dentro de um bouquet muda, todas as linhas que têm esse bouquet veem-no de imediato. Eliminar um bouquet remove o seu id de todas as linhas e pacotes. Alterar a ordem global dos bouquets só muda a ordem guardada nas linhas vendidas quando assinala a caixa "aplicar a linhas e pacotes vendidos"; o conjunto de bouquets de uma linha não muda.)

Só quando o seu grupo tem Allow Bouquet Selection ativo: assinala uma parte dos bouquets do pacote; nada assinalado = o pacote inteiro; os bouquets fora do pacote são descartados. O preço não muda.

A data de expiração (hoje + a duração do pacote), o número de ligações, os formatos de saída, restreamer, bloqueio de dispositivo, país forçado, servidor forçado, bloqueio de ISP, bouquets. Os valores que um revendedor introduz nestes campos são ignorados, exceto os bouquets (PKG-05) e o bloqueio de ISP quando o grupo tem Allow Line Restrictions ativo.

Um pacote que só pode ser vendido para esse tipo de set-top box; não pode ser vendido para uma linha normal nem para o outro tipo de dispositivo. Inversamente, um pacote tem de permitir o tipo de dispositivo antes de poder ser usado no formulário Add MAG / Add Enigma.

Tem de escolher um pacote que o seu grupo possa vender e ter créditos suficientes. Nome de utilizador / palavra-passe: escreva os seus (quando o grupo o permite) ou deixe-os vazios para serem gerados. Um admin também pode deixar um deles (ou ambos) vazio ao criar uma linha: o sistema gera 10 caracteres e mostra-os logo após guardar; o formulário de edição ainda exige um nome de utilizador.

O seu grupo tem Allow Username Change / Allow Password Change desativado: uma nova linha recebe valores gerados. Quando pode escrever os seus, o comprimento mínimo é definido pelo grupo (8 caracteres por predefinição).

No formulário de edição da linha e no diálogo Generate play link da lista de Lines. As palavras-passe das linhas são guardadas legíveis porque as aplicações IPTV e os links de playlist precisam delas. Uma palavra-passe gerada é mostrada logo após guardar.

Algumas linhas criadas por uma versão anterior do painel só têm uma palavra-passe com hash. Essa linha não pode iniciar sessão e o painel não mostra palavra-passe para ela. Defina uma nova palavra-passe no formulário de edição da linha e envie-a ao cliente.

Ativar / desativar, notas do revendedor, contacto, modelo de categoria, proprietário (dentro da sua própria árvore); nome de utilizador e palavra-passe quando o grupo o permite; restrições (IPs, user agents, bloqueio de ISP) quando o grupo tem Allow Line Restrictions ativo; uma nova seleção de bouquets dentro do pacote quando o grupo o permite. O pacote, a data de expiração, o número de ligações, a marca de teste, os formatos de saída, o bloqueio de dispositivo e o país não podem ser editados diretamente — só mudam através de uma renovação / mudança de pacote.

Duas formas, uma só regra:

• o botão Renew (charged) da lista: usa o pacote atual da linha;
• o campo Extend with package do formulário de edição: escolha qualquer pacote que possa vender (é também assim que muda de package).

Quando edita uma linha e escolhe uma renovação no mesmo guardar, ambos são uma só transação: se a renovação for recusada (créditos insuficientes, pacote não vendável), a edição também não é guardada e nenhum crédito é cobrado. Corrija e guarde novamente.

• A linha não expirou e o novo pacote é compatível com o antigo → o tempo é adicionado à data de expiração atual.
• A linha expirou, ou os dois pacotes não são compatíveis → conta a partir de hoje; o tempo restante não é mantido.

"Compatível" só é verificado quando o novo pacote tem a opção de verificação de compatibilidade ativa: ambos os pacotes têm de ter os mesmos bouquets, formatos de saída, número de ligações, marca de restreamer e bloqueio de dispositivo. Com a opção desativada, contam sempre como compatíveis. Os novos pacotes têm a opção ativa por predefinição (o admin pode desativá-la); os pacotes existentes mantêm a sua definição. Uma linha MAG / Enigma só pode ser renovada com, ou mudada para, um pacote que permita esse tipo de box.

Uma mudança de pacote = comprar um período oficial do novo pacote: é cobrado o preço total do novo pacote (o seu preço próprio, se tiver um), sem crédito pela parte não utilizada. A linha assume todas as propriedades do novo pacote.

Desativar: o cliente não pode iniciar sessão nem ver, as sessões em curso são fechadas em cerca de um minuto; o período de subscrição continua a correr; pode ativá-la novamente a qualquer momento. Eliminar: permanente, sem restauro, sem reembolso (DATA-01). Para um cliente que faz uma pausa, desative — não elimine.

O cliente é recusado até a linha ser renovada (uma linha que está expirada e banida vê o clip de "expirada", porque a expiração é verificada primeiro); as sessões em curso são fechadas em cerca de um minuto. A linha não é eliminada automaticamente: renove-a e volta a funcionar com o mesmo nome de utilizador / palavra-passe.

Sim: escolha uma conta abaixo da sua como proprietário. O proprietário vê a linha na sua própria lista. Os créditos continuam a ser cobrados a quem prime guardar.

As suas e as de todas as contas abaixo da sua. Uma linha fora da sua árvore não existe para si (a resposta é "não encontrada").

Para si, para recordar quem é o cliente (e-mail, número de telefone, número de encomenda). O subscritor nunca os vê. São apagados definitivamente quando a linha é eliminada.

Quando o grupo tem a permissão: Logs → Line Activity mostra o histórico de visualização de cada linha, e Logs → Live Connections mostra todas as ligações abertas das linhas da sua árvore (que linha, que canal, de que endereço) com um botão para a fechar. Live Connections só abre quando o admin ativou, para o seu grupo, a opção de ver o histórico de ligações dos clientes (a caixa client connection logs do formulário do grupo); nunca vê ligações de uma linha fora da sua árvore.

Uma linha que pertence a um código de ativação está oculta da lista por predefinição até filtrar por ela (CODE-02).

Sim. O campo Expires on do formulário de linha é uma data e hora no fuso horário do painel, pelo que uma linha pode expirar a uma hora específica. Abrir o formulário e guardar sem tocar neste campo mantém a expiração ao segundo — editar uma nota ou os bouquets não dá tempo extra a uma linha de teste de poucas horas. Um valor que não pode ser lido é assinalado no próprio campo e nunca se torna "nunca expira". A página de edição em massa continua a aceitar uma data, lida como o fim desse dia.

Quando todas estas condições se verificam: o admin não desativou os testes para revendedores; o pacote tem um período de teste; o seu grupo tem Allowed Trials > 0; os seus créditos são ≥ Minimum Trial Credits do grupo; e o número de linhas de teste que criou dentro da janela de contagem não atingiu a quota.

Conforme definido no grupo: dia = as últimas 24 horas, mês = os últimos 30 dias. Exemplo, uma quota de 5 / dia: no máximo 5 linhas de teste em quaisquer 24 horas. Um teste mais antigo liberta a sua vaga quando sai da janela.

Exatamente o preço de teste do pacote (normalmente 0). O preço próprio de um revendedor não se aplica aos testes.

Uma das condições de TRI-01 não está cumprida; o formulário indica o motivo junto à caixa.

Renove a linha com um pacote: a linha recebe um período oficial e deixa de ser um teste. O nome de utilizador e a palavra-passe mantêm-se, o cliente não tem de configurar nada novamente.

Não. Um teste é concedido uma vez, quando a linha é criada; uma linha existente só pode ser renovada com um período oficial (TRI-05). Para deixar um cliente experimentar de novo, crie uma nova linha de teste (conta para a quota de testes).

Lines → Generate play link: escolha o formato; o link é construído com o nome de utilizador e a palavra-passe da linha. Através da API, get_line devolve os links já prontos: m3u, m3u_hls, xmltv, player_api, web_player.

Qualquer aplicação que suporte a Xtream Codes API (IPTV Smarters, TiviMate, XCIPTV, GSE…): introduza o endereço do servidor + nome de utilizador + palavra-passe. Para uma aplicação que só aceita uma playlist, use o link M3U. As boxes MAG usam o portal, as boxes Enigma2 usam uma playlist / plugin. Sem qualquer dispositivo, use o web player num navegador.

MPEG-TS: mudança rápida de canal, adequado a aplicações IPTV e set-top boxes. HLS: funciona bem em navegadores, em dispositivos Apple e em redes instáveis. Uma linha só pode usar os formatos que o seu pacote permite; um link num formato não permitido é recusado.

m3u_plus (com logótipos, grupos, ids de EPG — a predefinição recomendada), m3u simples, os tipos para Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive e tipos de lista simples. Escolha um no diálogo Generate play link.

As aplicações Xtream obtêm-no por si próprias. Para uma aplicação M3U, use o link XMLTV da linha (uma playlist m3u_plus já inclui o endereço do EPG).

Sim, nos canais para os quais o admin ativou o arquivo; as aplicações mostram um ícone de catch-up nesses canais.

Em /player/ no servidor de API (o link web_player). Inicie sessão com o nome de utilizador / palavra-passe da linha, ou com um código de ativação.

Não. A palavra-passe faz parte do link e fica guardada na aplicação; após uma alteração de palavra-passe, o cliente tem de a introduzir novamente / obter um novo link. É também assim que corta o acesso a quem usa uma linha sem autorização.

Sim: defina Your own play address na página da chave de API (ou com a ação de API set_play_base). Aponta o DNS do domínio para o servidor de API do painel, e o operador tem de configurar o seu lado; informe o admin antes de o usar. O endereço aplica-se aos links que a API devolve ao seu sistema.

Tecnicamente partilham uma só linha, pelo que partilham o seu número de ligações (SEC-01) e podem esbarrar na regra do segundo IP (SEC-03). Cada cliente deve ter uma linha própria.

Devices → Add MAG / Add Enigma: introduza o MAC, escolha um pacote. O sistema vende uma nova linha e associa o dispositivo num só passo; o dispositivo inicia sessão pelo seu MAC, ninguém tem de escrever nome de utilizador / palavra-passe. Os créditos são cobrados exatamente como numa linha normal.

No formulário do dispositivo, escolha a linha existente do cliente em vez de um pacote: o dispositivo fica emparelhado com essa linha, sem custo. O cliente continua a usar a linha na aplicação; a box segue o pacote, a expiração, os bouquets e o estado da linha.

Partilham o limite de ligações: a aplicação e a box são um só subscritor.

Renove a sua linha (o link está no formulário do dispositivo). Para um dispositivo emparelhado, renove a linha do cliente — a box acompanha por si própria.

Edite o MAC no dispositivo. Se a linha tem o bloqueio de dispositivo ativo, limpe o número de série / id do dispositivo registado para que a nova box se possa registar.

Sim. Eliminar um dispositivo elimina também a sua linha (com o histórico de ligações e eventos pendentes). Para manter uma linha que foi paga, use o botão Convert to line: o dispositivo é removido e a linha torna-se uma linha normal. Quando elimina a linha de um cliente, um dispositivo emparelhado continua de forma independente com uma linha própria.

As suas próprias boxes MAG, sim: enviar uma mensagem para a TV, reproduzir um canal, recarregar o portal, reiniciar, fechar as ligações da linha (o grupo precisa da permissão para ver os logs de ligação dos clientes), repor o ISP registado e repor o bloqueio de STB. Os comandos X-Plugin e as capturas de ecrã das boxes Enigma, banir um dispositivo e mover um dispositivo para outra linha são apenas para o admin. Ativar / desativar o dispositivo de um revendedor ativa / desativa a sua linha; um revendedor não pode levantar Banned de um dispositivo.

Vender acesso sob a forma de código (um cartão raspadinha, um código enviado por mensagem): o cliente introduz o código numa aplicação ou no web player e pode ver, sem nome de utilizador / palavra-passe. O período só começa quando o cliente ativa o código pela primeira vez.

Active Codes → New: escolha o pacote, a quantidade (1–500 por lote), o comprimento do código (6–24), a opção só dígitos (fácil de escrever com o telecomando da TV), a opção de teste. Os créditos são cobrados na criação = preço do pacote × número de códigos. Cada código vem com uma linha própria, bloqueada até à ativação.

Letras maiúsculas e dígitos sem os que se confundem facilmente (0, O, 1, I); ou apenas dígitos. Um cliente que escreva em minúsculas é na mesma aceite.

Um. O código fica associado ao primeiro dispositivo que o ativa; outro dispositivo que introduza o mesmo código é recusado. Esse dispositivo pode introduzir o código as vezes que quiser, os dados de início de sessão da linha não mudam.

Use Reset device nesse código; o novo dispositivo pode então ativá-lo. Não é adicionado tempo ao período.

Introduzir vários códigos errados diferentes seguidos bloqueia o endereço IP durante algum tempo (SEC-08).

Na página Active Codes, assinale o código, escolha a ação Extend (days) e introduza o número de dias. Só um código ativado recebe dias (um código não utilizado ainda não começou o seu período); um código ainda válido é prolongado a partir da sua data de expiração atual, um expirado a partir de agora. Esta ação não cobra créditos, pelo que só um administrador a pode utilizar: um revendedor renova a linha do código como qualquer linha, com um pacote e o respetivo preço (Lines → Renew, ou renew_line na Reseller API). Uma cobrança errada é corrigida pelo suporte com um ajuste de créditos, nunca com uma prolongação gratuita. Admin API: extend_active_code.

Um código não utilizado criado pelo revendedor: reembolsado na totalidade, com uma linha no livro de créditos. Um código ativado: sem reembolso.

A página Batches mostra total / prontos / ativados / desativados de cada lote e exporta um ficheiro TXT (um código por linha). Ações em massa: ativar, desativar, repor dispositivo, eliminar.

Sim, como qualquer linha vendida com esse pacote: número de ligações, formatos de saída, bouquets, bloqueio de dispositivo, restreamer e também o país forçado do pacote (SEC-07). Um cliente que ative um código a partir de um país fora da lista permitida consegue ativá-lo, mas é recusado na reprodução.

É o número de dispositivos a ver ao mesmo tempo com uma linha. 0 = ilimitado. Abrir novamente o canal que já está a ver, a partir do mesmo dispositivo, não conta como outra ligação.

Por predefinição: a ligação nova entra e a mais antiga é fechada (dando preferência a uma ligação do mesmo dispositivo, depois do mesmo IP). O leitor fechado para em cerca de 30 segundos. O admin pode mudar para recusar a nova ligação em vez de fechar uma antiga.

Quando o admin a ativa: enquanto uma linha está a ser vista a partir de um IP, uma ligação em direto a partir de outro IP é recusada. A regra pode ser limitada a linhas com poucas ligações (por exemplo linhas com 1 ligação; uma linha com ligações ilimitadas só fica associada quando o limiar é 0). Com Match The Address By Network ativo, os endereços da mesma rede /24 (IPv6: /64) contam como um só espectador. É uma ferramenta contra a partilha de contas.

Quando o grupo tem Allow Line Restrictions ativo: o campo Allowed IPs (um IP, um intervalo CIDR ou um nome de domínio, um por linha; um domínio é resolvido no momento da ligação, por isso um IP dinâmico continua a funcionar) e Allowed User-Agents. Vazio = tudo permitido. Nota: estas restrições bloqueiam na reprodução; a aplicação continua a iniciar sessão e a mostrar a lista de canais.

A linha memoriza o fornecedor de internet da sua primeira ligação e recusa o uso a partir de outro fornecedor. Quando o cliente muda de fornecedor, desative e volte a ativar o bloqueio de ISP para registar o novo. Não se aplica às boxes MAG.

Associa a linha à primeira set-top box que inicia sessão (número de série, id do dispositivo); outra box é recusada. Decidido pelo pacote.

Uma linha só se pode ligar a partir do seu país forçado (ALL = qualquer lugar). Quando está vazio, aplica-se a lista geral de países permitidos do painel. Um cliente que viaje para o estrangeiro ou use uma VPN pode ser recusado por este motivo.

• Automaticamente: inícios de sessão falhados a partir de um IP com muitos nomes de utilizador / códigos de ativação diferentes num curto espaço de tempo, ou uma enxurrada de pedidos. Um bloqueio automático levanta-se por si após o tempo que o admin configurou (60 minutos por predefinição).
• Manualmente: o admin bloqueou o IP / intervalo de IPs; este não expira.

Enquanto um IP está bloqueado, nenhuma linha se pode ligar a partir dele. Errar repetidamente o mesmo nome de utilizador não provoca um bloqueio.

O admin pode bloquear por User-Agent (aplicação), por fornecedor de internet (ISP) e por ASN (por exemplo intervalos de alojamento / VPN). Uma linha para a qual o admin ativou "bypass UA" ignora a lista de bloqueio de aplicações.

Uma linha para um parceiro que puxa os streams para os redistribuir. Está isenta do limite de ligações, da regra do segundo IP, do fim automático de sessões longas e do bloqueio por ASN. Decidido pelo pacote / pelo admin; não se destina a espectadores normais.

O admin pode definir uma duração máxima para uma sessão contínua; depois dela a sessão é fechada e o cliente prime play para continuar. Uma sessão que perde o sinal durante cerca de 90 segundos também conta como fechada.

• A página Theft Detection (quando o grupo tem a permissão): ordena as linhas pelo número de filmes / episódios diferentes vistos em 1 hora / 24 horas / 7 dias, com o número de IPs diferentes — uma linha invulgarmente alta é suspeita.
• A página de atividade da linha: mostra os IPs e dispositivos em uso.
• O que fazer: alterar a palavra-passe da linha (PLAY-08), ativar a restrição de IP / bloqueio de ISP, ou desativar a linha.

Quando o seu grupo tem Can Create Sub-Resellers ativo e pelo menos um grupo em Groups for sub-resellers. Cada criação cobra a taxa de criação (créditos) definida no grupo. Uma árvore de revendedores tem no máximo 5 níveis de profundidade.

Escolhe um grupo da lista que o admin permite; esse grupo decide as permissões do subrevendedor, os pacotes vendáveis e a quota de testes.

E-mail, nome, palavra-passe, estado, grupo (da lista), notas, transferir / reaver créditos, e todas as linhas abaixo dele. Não pode alterar a sua função nem o proprietário.

Nada: cada conta só vê o que está abaixo dela, nunca os níveis acima nem outros ramos.

O grupo precisa de Can Delete Users ativo. Os créditos restantes, as linhas e as contas filhas passam para a conta que elimina. As linhas dos clientes continuam a funcionar. Os dados pessoais da conta eliminada (nome de utilizador, e-mail, nome, palavra-passe, chaves de API, notas) são apagados; esse nome de utilizador e e-mail podem voltar a ser usados.

Quando o admin ativou o e-mail de boas-vindas: a nova conta recebe o seu nome de início de sessão e um link de início de sessão. O e-mail nunca contém a palavra-passe — envie-lha por si.

Para reordenar, renomear ou ocultar as categorias (direto, filmes, séries, rádio) que um cliente vê na aplicação — por linha, sem mexer nas categorias do próprio painel.

Todo o conteúdo dessa categoria fica também oculto na aplicação e na playlist das linhas que usam o modelo.

Sim, de imediato para todas as linhas a que o modelo está atribuído. Quando um modelo é eliminado, as suas linhas voltam à disposição predefinida.

Ver: os seus e os das contas abaixo da sua, os modelos do sistema e os modelos partilhados pelos níveis acima. Editar: apenas os seus e os de baixo. Para ajustar um modelo do sistema, duplique-o e edite a cópia.

A ordem personalizada das categorias não se aplica à parte de filmes / séries de uma playlist M3U (os nomes e a ocultação continuam a aplicar-se). As aplicações que usam a Xtream API recebem tudo.

Para o seu próprio sistema (loja web, faturação, bot) vender e gerir linhas / subrevendedores sem abrir o dashboard. Endereço: {API}/reseller/v1, autenticado com o cabeçalho X-API-Key. A documentação completa está em /docs/ no servidor de API.

A página API Key. Uma chave é mostrada uma vez, quando é criada — copie-a de imediato. Se a perder, crie uma nova chave (a antiga deixa de funcionar).

É melhor não. Crie uma chave adicional por sistema: dê-lhe um nome, limite os IPs / CIDRs que a podem usar, opcionalmente torne-a só de leitura (apenas listar e ver) e revogue-a individualmente sem afetar as outras chaves.

Todas as regras do dashboard (grupo, preço próprio, quota de testes, âmbito da árvore) aplicam-se através da API exatamente da mesma forma.

Não, desde que envie o mesmo request_id para a mesma transação: o sistema devolve o resultado anterior. O request_id de uma renovação fica associado a essa linha: reutilizá-lo para outra linha devolve um erro de conflito (HTTP 409) e a outra linha não muda — gere um novo request_id para cada transação.

A página API Key tem uma tabela de chamadas de API recentes (30 dias): ação, resultado, código de erro, endereço de origem, nome do conector. Os parâmetros nunca são registados.

O painel avisa o seu sistema quando algo acontece, para que não tenha de estar sempre a perguntar. Eventos: line.created, line.renewed, line.enabled, line.disabled, line.deleted, line.expiring (3 dias antes), line.expired, credits.low (abaixo do limiar que definir). O endereço recetor tem de ser https e acessível a partir da internet.

Cada notificação traz a assinatura X-Xtream-Signature: sha256=HMAC(secret, timestamp.body); o segredo é mostrado uma vez, quando o endpoint é criado. Um webhook nunca contém uma palavra-passe.

Cada notificação é tentada 3 vezes; um endpoint que falhe 20 entregas seguidas é desligado. Corrija o seu lado, use Send test e depois crie novamente o endpoint se tiver sido desligado.

Sim, mas apenas ao proprietário da linha (o próprio e os níveis acima de si na árvore). Não guarde palavras-passe de linhas em logs nem as envie por um canal inseguro.

Sim, quando envia package_id com ela (o nome antigo package também é aceite): além da edição, a ação vende um período oficial desse pacote exatamente como change_package — mesmo preço, mesmo request_id, e a resposta traz credits_charged. A edição e a renovação são uma só transação: quando é recusada (créditos insuficientes, pacote inválido, trial enviado em conjunto) nada muda. edit_line sem pacote só edita nome de utilizador, palavra-passe, contacto e notas e não toca no pacote nem na expiração.

Não tal como está. A API mantém os nomes de ação familiares mas é uma nova interface: o endereço /reseller/v1, uma chave de API criada neste painel, ações de escrita enviadas com POST, erros devolvidos como um estado HTTP com um campo error, e o resultado da criação de uma linha em data.line. Use a documentação em /docs/ ou um conector já pronto (CON-02).

Com o seu próprio sistema e gateway de pagamento. O painel não processa pagamentos. Um conector liga o seu sistema de loja ao painel: o cliente paga do seu lado → o conector chama a Reseller API para criar / renovar a linha.

WHMCS, Blesta, WISECP, HostBill, ClientExec, FOSSBilling, Paymenter, WordPress (WooCommerce / Easy Digital Downloads), Odoo, PrestaShop, OpenCart, Magento, Dolibarr, ERPNext, e uma "webhook bridge" para Shopify, Upmind e Invoice Ninja.

No painel: barra lateral Recursos → Todos os conectores — cada conector com os seus dados de ligação, passos de instalação, um botão Transferir e o SHA-256 do ficheiro para o verificar.

Os mesmos conectores, com os respetivos passos de instalação e somas de verificação, estão publicados em https://plugins.xtream-ui.pro; o código-fonte está em https://github.com/xtreamui-pro/plugins.

Difere por conector, e a página de cada conector di-lo: alguns correram dentro da plataforma real (por exemplo WordPress + WooCommerce, Odoo, FOSSBilling, Paymenter), outros só tiveram o núcleo testado. Leia a linha "how it was tested" e experimente num ambiente de teste antes de vender a sério.

Um conector apenas chama a Reseller API com a sua chave de API — pode fazer exatamente o que o próprio pode fazer, nada mais. O código-fonte é aberto para o ler e verificar. Dê a cada conector uma chave própria com limite de IP (API-03).

Linhas (criar, renovar, mudar de pacote, suspender, eliminar) e contas de subrevendedor com créditos.

Integre-a por si com a Reseller API (API-01) e webhooks, ou envie um pedido através do canal de suporte.

Não. Eliminado é eliminado: os dados da linha (nome de utilizador, palavra-passe, contacto, notas), o seu histórico de ligações (IPs, dispositivos, o que foi visto), as set-top boxes associadas à linha e o seu código de ativação. Não há reciclagem nem função ou API de restauro. Quando o cliente voltar, crie uma nova linha.

Apenas um registo estatístico anónimo para o operador (cliente novo ou recorrente, que pacotes são populares). Não contém nada legível sobre o cliente e nenhum revendedor, conector ou API lhe pode aceder.

Não. As cópias de segurança da base de dados só existem para reconstruir o sistema após um incidente e são mantidas pelo operador; não são usadas para desfazer uma eliminação. As cópias antigas são rotativas, pelo que os dados eliminados também desaparecem delas.

A palavra-passe de uma linha tem de ser escrita nas aplicações e faz parte do link da playlist, por isso o painel mantém-na legível para o proprietário da linha. As palavras-passe das contas do painel são guardadas apenas com hash.

Você, as contas acima de si na sua árvore e o admin. Outros revendedores e os níveis abaixo de si não podem.

Nunca. Os clientes de uma linha pertencem ao revendedor; contacta-os através do seu próprio sistema.

De duas formas: um e-mail diário de resumo das linhas prestes a expirar (quando o admin o ativou; 3 dias antes por predefinição), e os webhooks line.expiring / line.expired para o seu sistema.

Normalmente um dos bloqueios de reprodução (linhas 5–9 de FIX-01): o início de sessão e a lista de canais não verificam o IP / aplicação, só a reprodução o faz. Se falha apenas um canal em todas as linhas → o canal de origem tem um problema; indique ao admin o nome do canal e a hora.

Verifique os bouquets da linha (PKG-04, PKG-05) e o modelo de categorias atribuído (CAT-02). Após uma alteração, peça ao cliente que recarregue a lista na aplicação. Um canal que o admin acabou de adicionar aparece ao fim de cerca de meio minuto; se um canal está no bouquet e nenhuma linha o vê, o admin pode ter retirado esse canal do ar.

Experimente por ordem: outro canal (um canal ou todos?) → outra rede → outro formato (HLS em vez de MPEG-TS) → outra aplicação. Todos os canais falham em todas as redes → indique ao suporte o nome de utilizador, a hora e o canal.

Uma aplicação M3U precisa que o link XMLTV seja adicionado (PLAY-05). Um canal sem EPG na origem não mostra programação.

Por ordem: nenhum pacote escolhido · o pacote não é para o seu grupo (PKG-02) · créditos insuficientes (CRD-05) · o nome de utilizador já existe ou é mais curto que o mínimo (LINE-02) · a quota de testes está esgotada (TRI-01).

429: a linha está a descarregar demasiadas playlists / ficheiros EPG ao mesmo tempo — aguarde e tente novamente. Página 404: o sistema responde 404 a todas as recusas (dados errados, expirada, bloqueada, acima de um limite) para que o motivo não seja revelado a estranhos; verifique com FIX-01.

O seu grupo não tem permissão para essa página (ACC-02). Live Connections precisa adicionalmente que o admin ative a opção de ver as ligações dos clientes para o grupo (LINE-15).

O e-mail só é enviado quando o admin configurou um servidor de correio e ativou esse tipo de mensagem; a conta tem de ter um endereço de e-mail real. Verifique a pasta de spam.