Centro de ajuda
Perguntas e respostas
Como funcionam os créditos, packages, linhas, links de reprodução e dispositivos — e o que verificar quando algo não reproduz.
139 de 139 perguntas
Como utilizar esta página
Cada pergunta tem um código fixo (por exemploLINE-07). Indique-o ao contactar o suporte ou copie o link da pergunta.
Os nomes de menus, botões e campos estão escritos como o painel os mostra. Umutilizadoré uma conta que inicia sessão no painel (administrador, distribuidor); umalinhaé a subscrição IPTV de um espectador. Os dois nunca se misturam.
- Espectador Um distribuidor pode reencaminhar esta resposta a um espectador tal como está
- Administrador Para o operador do painel
Visão geral do serviço e quem é responsável por quê
GENGEN-01 O que fornece este serviço?
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 distribuidores usam-no para dar aos seus clientes o direito de ver (linhas).
GEN-02 O que o serviço não faz?
- 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 distribuidor (verCON-01).
- Não contacta os espectadores de um distribuidor. 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 (verDATA-01).
GEN-03 Quem é quem no sistema?
| Função | Quem é | Onde inicia sessão |
|---|---|---|
| Admin | o operador do painel | dashboard |
| Reseller (distribuidor) | vende linhas; recebe créditos do admin | dashboard, Reseller API |
| Sub-reseller (sub-distribuidor) | um distribuidor criado abaixo de outro distribuidor | dashboard, Reseller API |
| Line (linha) | um assinante — o espectador final | aplicação IPTV, set-top box, web player.Nuncao dashboard |
GEN-04 Que passos levam um canal até ao espectador?
- O admin constrói o catálogo (canais, filmes, séries, rádio) e agrupa-o embouquets.
- O admin cria umpackage: bouquets + duração + número de ligações + preço em créditos.
- Um distribuidor gasta créditos para vender o package → o sistema cria umalinha.
- 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.
GEN-05 O que pode um distribuidor fazer com o conteúdo, e o que não pode?
Um distribuidor podeveras listas de canais, filmes, séries, rádio, bouquets e packages (quando o seu grupo tem a permissão), mas não pode adicionar, editar nem eliminar conteúdo. O conteúdo e os packages são geridos pelo admin. Um distribuidor decide o que cada cliente pode ver escolhendo o package (e os bouquets, quando o grupo o permite —PKG-05).
GEN-06 Onde obtenho suporte?
A entradaSupportda 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.
GEN-07 Que idiomas tem a interface?
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.
Contas do painel e início de sessão
ACCACC-01 Porque não pode o meu cliente iniciar sessão no dashboard?
É 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 distribuidor não pode ser usada para ver canais.
ACC-02 Vejo menos menus do que esta página descreve. Porquê?
Os menus e as ações dependem dogrupoque 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.
ACC-03 Onde altero a minha palavra-passe do painel?
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 distribuidor principal ou o admin) que defina uma nova.
ACC-04 Porque é que a minha sessão termina quando mudo de rede?
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.
ACC-05 O que acontece após várias tentativas de início de sessão falhadas?
O painel limita os inícios de sessão falhados (configurado pelo admin). Depois do limite, tem de esperar antes de tentar novamente.
ACC-06 Em que difere uma conta demo de uma conta real?
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.
ACC-07 A minha conta está "desativada". O que significa?
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.
ACC-08 Onde reviso o que eu e os meus sub-distribuidores fizemos?
Logs → Reseller Logs(quando o grupo pode ver logs): cada linha ou dispositivo criado, editado, renovado, ativado / desativado ou eliminado, cada sub-distribuidor 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.
Créditos
CRDCRD-01 O que é um crédito?
A unidade pré-paga do painel. Cada venda (criar uma linha, renovar, criar códigos de ativação, criar um sub-distribuidor) consome créditos de acordo com o preço do package 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.
CRD-02 Como carrego créditos?
Os créditos fluem de cima para baixo: o admin dá créditos a um distribuidor, um distribuidor transfere-os para um sub-distribuidor. O pagamento à conta acima da sua é feito fora do painel.
CRD-03 Os créditos de quem são cobrados?
Sempre os daconta que executa a ação, mesmo quando a linha é atribuída a um sub-distribuidor abaixo.
CRD-04 Onde vejo o meu histórico de créditos?
A páginaCredits: 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.
CRD-05 E se não tiver créditos suficientes?
A ação inteira é recusada: nenhuma linha é criada e nada é cobrado. Um saldo nunca fica negativo.
CRD-06 Se premir guardar duas vezes ou a rede falhar, sou cobrado duas vezes?
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.
CRD-07 Recebo créditos de volta quando elimino uma linha?
CRD-08 Posso reaver créditos que transferi para um sub-distribuidor?
Sim: no formulário de edição do sub-distribuidor, introduza um número negativo no campo de transferência de créditos. Nenhum saldo pode ficar abaixo de 0.
CRD-09 Como sei com antecedência quantas linhas posso comprar?
O seletor de package do formulário de linha mostra o seu preço. Através da API, a açãopricingdevolve o seu saldo, o preço de cada package e quantos pode comprar.
Packages, bouquets e preços
PKGPKG-01 Qual é a diferença entre um bouquet e um package?
Umbouqueté uma lista de conteúdo (canais, filmes, séries). Umpackageé 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).
PKG-02 Porque não vejo um determinado package?
Um package só pode ser vendido pelos grupos que o admin selecionou para ele. Um package que não se destina ao seu grupo não aparece no seletor e é recusado quando enviado através da API.
PKG-03 O meu preço difere do preço do package. Porquê?
O admin pode definir umpreço própriopor distribuidor para cada package (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ãose aplica aos testes.
PKG-04 Quando o admin altera os bouquets de um package, as linhas já vendidas também mudam?
Não. Os bouquets sãocopiados para a linhano momento da venda; editar o package depois não afeta as linhas já vendidas. Uma linha recebe os novos bouquets do package na sua próxima renovação / mudança de package. (Quando o conteúdodentrode 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 packages. Alterar a ordem global dos bouquets só muda a ordem guardada nas linhas vendidas quando assinala a caixa "aplicar a linhas e packages vendidos"; o conjunto de bouquets de uma linha não muda.)
PKG-05 Posso vender apenas parte de um package?
Só quando o seu grupo temAllow Bouquet Selectionativo: assinala uma parte dos bouquets do package; nada assinalado = o package inteiro; os bouquets fora do package são descartados. O preço não muda.
PKG-06 Que propriedades de uma linha são decididas pelo package?
A data de expiração (hoje + a duração do package), 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 distribuidor introduz nestes campos são ignorados, exceto os bouquets (PKG-05) e o bloqueio de ISP quando o grupo temAllow Line Restrictionsativo.
PKG-07 O que é um package "MAG only" / "Enigma only"?
Um package 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 package tem de permitir o tipo de dispositivo antes de poder ser usado no formulário Add MAG / Add Enigma.
Linhas: criar, editar, renovar, eliminar
LINELINE-01 O que preciso para criar uma linha?
Tem de escolher um package 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 deediçãoainda exige um nome de utilizador.
LINE-02 Porque não posso escolher eu o nome de utilizador / palavra-passe?
O seu grupo temAllow Username Change/Allow Password Changedesativado: uma nova linha recebe valores gerados. Quando pode escrever os seus, o comprimento mínimo é definido pelo grupo (8 caracteres por predefinição).
LINE-03 Onde posso voltar a ver a palavra-passe de uma linha?
No formulário de edição da linha e no diálogoGenerate play linkda 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.
LINE-04 Uma linha antiga não mostra palavra-passe e o cliente não consegue iniciar sessão?
Algumas linhas criadas por uma versão anterior do painel só têm uma palavra-passe com hash. Essa linhanão pode iniciar sessãoe 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.
LINE-05 O que pode um distribuidor editar numa linha após a venda?
Ativar / desativar, notas do distribuidor, 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 temAllow Line Restrictionsativo; uma nova seleção de bouquets dentro do package quando o grupo o permite. O package, 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ísnãopodem ser editados diretamente — só mudam através de uma renovação / mudança de package.
LINE-06 Como renovo uma linha?
Duas formas, uma só regra:
- o botãoRenew (charged)da lista: usa o package atual da linha;
- o campoExtend with packagedo formulário de edição: escolha qualquer package que possa vender (é também assim quemuda de package).
Quando edita uma linha e escolhe uma renovação no mesmo guardar, ambos sãouma só transação: se a renovação for recusada (créditos insuficientes, package não vendável), a edição tambémnãoé guardada e nenhum crédito é cobrado. Corrija e guarde novamente.
LINE-07 O tempo restante é mantido quando renovo?
- A linhanão expiroue o novo package écompatívelcom o antigo → o tempo é adicionado à data de expiração atual.
- A linhaexpirou, ou os dois packages não são compatíveis → conta a partir de hoje; o tempo restante não é mantido.
"Compatível" só é verificado quando o novo package tem a opção de verificação de compatibilidade ativa: ambos os packages 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 packages têm a opção ativa por predefinição (o admin pode desativá-la); os packages existentes mantêm a sua definição. Uma linha MAG / Enigma só pode ser renovada com, ou mudada para, um package que permita esse tipo de box.
LINE-08 Como é cobrada uma mudança de package (upgrade / downgrade)?
Uma mudança de package = comprar um período oficial do novo package: é cobrado o preço total do novo package (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 package.
LINE-09 Qual é a diferença entre desativar e eliminar uma linha?
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.
LINE-10 O que significam os estados de uma linha?
| Estado | Significado | Quem o pode levantar |
|---|---|---|
| Active | utilizável | — |
| Disabled | desligada pelo distribuidor / proprietário | distribuidor |
| Banned | bloqueada pelo admin | apenas o admin |
| Expired | passou a data de expiração | uma renovação |
| Trial | uma linha de teste, utilizável até ao fim do período de teste | torna-se oficial na renovação |
LINE-11 O que acontece quando uma linha expira?
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 linhanãoé eliminada automaticamente: renove-a e volta a funcionar com o mesmo nome de utilizador / palavra-passe.
LINE-12 Posso entregar uma linha a um sub-distribuidor?
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.
LINE-13 As linhas de quem vejo?
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").
LINE-14 Para que servem os campos "Contact" e "Reseller notes"?
Para si, para recordar quem é o cliente (e-mail, número de telefone, número de encomenda). O assinante nunca os vê. São apagados definitivamente quando a linha é eliminada.
LINE-15 Posso ver o que uma linha está a ver e a partir de onde?
Quando o grupo tem a permissão:Logs → Line Activitymostra o histórico de visualização de cada linha, eLogs → Live Connectionsmostra 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 caixaclient connection logsdo formulário do grupo); nunca vê ligações de uma linha fora da sua árvore.
LINE-16 Porque não mostra a lista de Lines as linhas dos códigos de ativação?
LINE-17 A data de expiração do formulário de linha inclui uma hora? Administrador
Sim. O campoExpires ondo formulário de linha é uma datae horano 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.
Testes (trials)
TRITRI-01 Quando posso criar uma linha de teste?
Quandotodasestas condições se verificam: o admin não desativou os testes para distribuidores; o package tem um período de teste; o seu grupo temAllowed Trials> 0; os seus créditos são ≥Minimum Trial Creditsdo grupo; e o número de linhas de teste que criou dentro da janela de contagem não atingiu a quota.
TRI-02 Em que janela é contada a quota de testes?
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.
TRI-03 Um teste custa créditos?
Exatamente o preço de teste do package (normalmente 0). O preço próprio de um distribuidor não se aplica aos testes.
TRI-04 Porque está bloqueada a caixa de teste?
TRI-05 Como transformo um teste numa linha oficial?
Renove a linha com um package: 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.
TRI-06 Posso dar a uma linha existente outro período de teste?
Links de reprodução, aplicações e formatos
PLAYPLAY-01 Onde obtenho o link para o meu cliente?
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_linedevolve os links já prontos:m3u,m3u_hls,xmltv,player_api,web_player.
PLAY-02 Que aplicações pode um cliente usar? Espectador
Qualquer aplicação que suporte aXtream 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 linkM3U. As boxesMAGusam o portal, as boxesEnigma2usam uma playlist / plugin. Sem qualquer dispositivo, use oweb playernum navegador.
PLAY-03 MPEG-TS ou HLS?
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 package permite; um link num formato não permitido é recusado.
PLAY-04 Que tipos de playlist existem?
m3u_plus(com logótipos, grupos, ids de EPG — a predefinição recomendada),m3usimples, os tipos para Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive e tipos de lista simples. Escolha um no diálogo Generate play link.
PLAY-05 De onde vem o guia de programação (EPG)? Espectador
As aplicações Xtream obtêm-no por si próprias. Para uma aplicação M3U, use o linkXMLTVda linha (uma playlistm3u_plusjá inclui o endereço do EPG).
PLAY-06 Existe catch-up? Espectador
Sim, nos canais para os quais o admin ativou o arquivo; as aplicações mostram um ícone de catch-up nesses canais.
PLAY-07 Onde está o web player e como inicio sessão? Espectador
Em/player/no servidor de API (o linkweb_player). Inicie sessão com o nome de utilizador / palavra-passe da linha, ou com um código de ativação.
PLAY-08 Um link antigo continua a funcionar depois de eu alterar a palavra-passe da linha?
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.
PLAY-09 Posso usar o meu próprio domínio para os links de reprodução?
Sim: definaYour own play addressna página da chave de API (ou com a ação de APIset_play_base). Aponta o DNS do domínio para o servidor de API do painel,eo 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.
Set-top boxes MAG / Enigma2
DEVDEV-01 Como adiciono uma box MAG / Enigma?
Devices → Add MAG / Add Enigma: introduza o MAC, escolha um package. 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.
DEV-02 O cliente já tem uma linha e quer adicionar uma box?
No formulário do dispositivo, escolha alinha existentedo cliente em vez de um package: o dispositivo ficaemparelhadocom essa linha, sem custo. O cliente continua a usar a linha na aplicação; a box segue o package, a expiração, os bouquets e o estado da linha.
DEV-03 Como são contadas as ligações de uma aplicação e box emparelhadas?
Partilhamo limite de ligações: a aplicação e a box são um só assinante.
DEV-04 Como renovo uma box?
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.
DEV-05 O cliente substitui a box por uma nova?
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.
DEV-06 Eliminar um dispositivo elimina a linha?
Sim. Eliminar um dispositivo elimina também a sua linha (com o histórico de ligações e eventos pendentes), como no painel antigo. Para manter uma linha que foi paga, use o botãoConvert 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.
DEV-07 Pode um distribuidor controlar uma box remotamente?
As suas próprias boxesMAG, 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 boxesEnigma, banir um dispositivo e mover um dispositivo para outra linha são apenas para o admin. Ativar / desativar o dispositivo de um distribuidor ativa / desativa a sua linha; um distribuidor não pode levantarBannedde um dispositivo.
Códigos de ativação
CODECODE-01 Para que serve um código de ativação?
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íodosó começa quando o cliente ativa o código pela primeira vez.
CODE-02 Como crio códigos e quanto custam?
Active Codes → New: escolha o package, 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 cobradosna criação= preço do package × número de códigos. Cada código vem com uma linha própria, bloqueada até à ativação.
CODE-03 Que carateres contém um código?
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.
CODE-04 Em quantos dispositivos pode ser usado um código? Espectador
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.
CODE-05 E se o cliente mudar de dispositivo?
UseReset devicenesse código; o novo dispositivo pode então ativá-lo. Não é adicionado tempo ao período.
CODE-06 O cliente recebe um erro ao introduzir o código. O que significa? Espectador
| Mensagem | Significado | O que fazer |
|---|---|---|
INVALID_CODE | código errado / o código não existe | verifique cada caráter; não escreva os hífenes |
DEVICE_MISMATCH | o código está associado a outro dispositivo | o distribuidor repõe o dispositivo (CODE-05) |
DISABLED | o código está desligado | o distribuidor volta a ativá-lo |
EXPIRED | o período terminou | comprar um código / prolongar |
Introduzir vários códigos errados diferentes seguidos bloqueia o endereço IP durante algum tempo (SEC-08).
CODE-07 Como prolongo um código que foi ativado?
Na páginaActive Codes, assinale o código, escolha a açãoExtend (days)e introduza o número de dias. Só um códigoativadorecebe 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. Através da API:extend_active_code.
CODE-08 Recebo créditos de volta quando elimino um código?
Um códigonão utilizadocriado pelo distribuidor: reembolsado na totalidade, com uma linha no livro de créditos. Um códigoativado: sem reembolso.
CODE-09 Como giro muitos códigos de uma vez?
A páginaBatchesmostra 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.
CODE-10 A linha de um código de ativação segue os limites do package?
Sim, como qualquer linha vendida com esse package: número de ligações, formatos de saída, bouquets, bloqueio de dispositivo, restreamer e também opaís forçadodo package (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.
Limites de ligação e bloqueios que protegem uma linha
SECSEC-01 Como é contado o "Max connections"?
É o número de dispositivos a verao mesmo tempocom 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.
SEC-02 Quem é desligado quando o limite é excedido? Espectador
Por predefinição: a ligaçãonovaentra e amais 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 pararecusar a nova ligaçãoem vez de fechar uma antiga.
SEC-03 O que é a regra do "segundo IP"?
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). ComMatch The Address By Networkativo, os endereços da mesma rede /24 (IPv6: /64) contam como um só espectador. É uma ferramenta contra a partilha de contas.
SEC-04 Posso restringir uma linha a certos IPs ou aplicações?
Quando o grupo temAllow Line Restrictionsativo: o campoAllowed 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) eAllowed User-Agents. Vazio = tudo permitido. Nota: estas restrições bloqueiam nareprodução; a aplicação continua a iniciar sessão e a mostrar a lista de canais.
SEC-05 O que é o bloqueio de ISP?
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.
SEC-06 O que é o bloqueio de dispositivo?
Associa a linha à primeira set-top box que inicia sessão (número de série, id do dispositivo); outra box é recusada. Decidido pelo package.
SEC-07 Como funciona a restrição de país?
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.
SEC-08 Porque está um endereço IP bloqueado? Espectador
- 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,nenhumalinha se pode ligar a partir dele. Errar repetidamente o mesmo nome de utilizador não provoca um bloqueio.
SEC-09 Por que outros motivos pode uma ligação ser bloqueada?
O admin pode bloquear porUser-Agent(aplicação), porfornecedor de internet (ISP)e porASN(por exemplo intervalos de alojamento / VPN). Uma linha para a qual o admin ativou "bypass UA" ignora a lista de bloqueio de aplicações.
SEC-10 O que é um restreamer?
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 package / pelo admin; não se destina a espectadores normais.
SEC-11 Uma sessão contínua muito longa é cortada? Espectador
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.
SEC-12 Como detetar uma linha partilhada ou roubada?
- A páginaTheft Detection(quando o grupo tem a permissão): ordena as linhas pelo número de filmes / episódiosdiferentesvistos 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.
Sub-distribuidores
SUBSUB-01 Posso criar sub-distribuidores?
Quando o seu grupo temCan Create Sub-Resellersativo e pelo menos um grupo emGroups for sub-resellers. Cada criação cobra a taxa de criação (créditos) definida no grupo. Uma árvore de distribuidores tem no máximo 5 níveis de profundidade.
SUB-02 A que grupo pertence um sub-distribuidor e o que pode fazer?
Escolhe um grupo da lista que o admin permite; esse grupo decide as permissões do sub-distribuidor, os packages vendáveis e a quota de testes.
SUB-03 O que posso gerir num sub-distribuidor?
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.
SUB-04 O que vê um sub-distribuidor das minhas coisas?
Nada: cada conta só vê o que está abaixo dela, nunca os níveis acima nem outros ramos.
SUB-05 Para onde vão as linhas e os créditos de um sub-distribuidor quando o elimino?
O grupo precisa deCan Delete Usersativo. Os créditos restantes, as linhas e as contas filhas passam paraa 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.
SUB-06 Um novo sub-distribuidor recebe um e-mail?
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-mailnuncacontém a palavra-passe — envia-lha você.
Modelos de categorias
CATCAT-01 Para que serve um modelo de categorias?
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.
CAT-02 O que acontece quando oculto uma categoria?
Todo o conteúdo dessa categoria fica também oculto na aplicação e na playlist das linhas que usam o modelo.
CAT-03 Quando edito um modelo, as linhas que o usam mudam?
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.
CAT-04 Que modelos posso ver e editar?
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-oe edite a cópia.
CAT-05 Limites que vale a pena conhecer?
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.
Reseller API, chaves de API, webhooks
APIAPI-01 Para que serve a Reseller API?
Para o seu próprio sistema (loja web, faturação, bot) vender e gerir linhas / sub-distribuidores sem abrir o dashboard. Endereço:{API}/reseller/v1, autenticado com o cabeçalhoX-API-Key. A documentação completa está em/docs/no servidor de API.
API-02 Onde obtenho uma chave de API?
A páginaAPI Key. Uma chave é mostradauma vez, quando é criada — copie-a de imediato. Se a perder, crie uma nova chave (a antiga deixa de funcionar).
API-03 Devo usar uma só chave para todos os sistemas?
É melhor não. Crie umachave adicionalpor sistema: dê-lhe um nome, limite os IPs / CIDRs que a podem usar, opcionalmente torne-asó de leitura(apenas listar e ver) e revogue-a individualmente sem afetar as outras chaves.
API-04 O que pode fazer a API?
| Necessidade | Ação |
|---|---|
| Saldo, preços, quantos pode comprar, regras de nome de utilizador / teste | user_info,pricing,packages |
| Linhas | get_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line |
| Sub-distribuidores | get_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user |
| Códigos de ativação | criar, listar, ativar / desativar, repor dispositivo, eliminar |
| Webhooks, endereço de reprodução próprio, log de chamadas da API | create_webhook…,set_play_base,api_logs |
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.
API-05 Se repetir após um erro de rede, sou cobrado duas vezes?
Não, desde que envie o mesmorequest_idpara a mesma transação: o sistema devolve o resultado anterior. Orequest_idde uma renovação ficaassociado a essa linha: reutilizá-lo para outra linha devolve um erro de conflito (HTTP 409) e a outra linha não muda — gere um novorequest_idpara cada transação.
API-06 A minha integração não funciona. Como a verifico eu próprio?
A página API Key tem uma tabela dechamadas 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.
API-07 O que é um webhook e que eventos existem?
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.
API-08 Como sei que um webhook é genuíno?
Cada notificação traz a assinaturaX-Xtream-Signature: sha256=HMAC(secret, timestamp.body); o segredo é mostrado uma vez, quando o endpoint é criado. Um webhook nunca contém uma palavra-passe.
API-09 O webhook deixou de enviar?
Cada notificação é tentada 3 vezes; um endpoint que falhe 20 entregas seguidas é desligado. Corrija o seu lado, useSend teste depois crie novamente o endpoint se tiver sido desligado.
API-10 A API devolve as palavras-passe das linhas?
Sim, mas apenas ao proprietário da linha (você 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.
API-11 Pode `edit_line` renovar uma linha?
Sim, quando enviapackage_idcom ela (o nome antigopackagetambém é aceite): além da edição, a ação vende um período oficial desse package exatamente comochange_package— mesmo preço, mesmorequest_id, e a resposta trazcredits_charged. A edição e a renovação são uma só transação: quando é recusada (créditos insuficientes, package inválido,trialenviado em conjunto) nada muda.edit_linesempackage só edita nome de utilizador, palavra-passe, contacto e notas e não toca no package nem na expiração.
API-12 Um script escrito para o painel antigo (PHP) funciona com esta API?
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 campoerror, e o resultado da criação de uma linha emdata.line. Use a documentação em/docs/ou um conector já pronto (CON-02).
Conectores para sistemas de loja / faturação
CONCON-01 Como cobro dinheiro aos meus clientes?
Com oseu própriosistema 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.
CON-02 Para que plataformas existe um conector?
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.
CON-03 Onde descarrego e instalo um?
Barra lateralResources → All Connectors: cada conector tem uma descrição, os dados de ligação, os passos de instalação, um botãoDownloade o SHA-256 do ficheiro para o verificar.
CON-04 Até que ponto foram testados os conectores?
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.
CON-05 Um conector é seguro e o que faz ao painel?
CON-06 O que pode um conector vender?
Linhas (criar, renovar, mudar de package, suspender, eliminar) e contas de sub-distribuidor com créditos.
Dados, eliminação e privacidade
DATADATA-01 Uma linha eliminada pode ser restaurada?
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.
DATA-02 O que guarda o sistema após uma eliminação?
Apenas um registo estatísticoanónimopara o operador (cliente novo ou recorrente, que packages são populares). Não contém nada legível sobre o cliente e nenhum distribuidor, conector ou API lhe pode aceder.
DATA-03 Uma cópia de segurança pode recuperar uma linha eliminada?
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.
DATA-04 Porque é a palavra-passe de uma linha legível e a de um painel não?
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.
DATA-05 Quem pode ver as minhas linhas e clientes?
Você, as contas acima de si na sua árvore e o admin. Outros distribuidores e os níveis abaixo de si não podem.
DATA-06 O painel envia e-mails / mensagens aos meus clientes?
Nunca. Os clientes de uma linha pertencem ao distribuidor; contacta-os através do seu próprio sistema.
DATA-07 Sou avisado antes de uma linha expirar?
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 webhooksline.expiring/line.expiredpara o seu sistema.
Resolução de problemas
FIXVerifique de cima para baixo. A maioria dos problemas de "não consigo ver" está nas primeiras 5 linhas.
FIX-01 O cliente não consegue iniciar sessão / não consegue ver Espectador
| # | Verificar | Sinal | O que fazer |
|---|---|---|---|
| 1 | Nome de utilizador / palavra-passe | a aplicação indica dados errados | compare com o formulário da linha (maiúsculas e minúsculas contam, sem espaços); envie novamente o link deGenerate play link |
| 2 | Expiração | a aplicação indicaExpired | renovar (LINE-06) |
| 3 | Estado | Disabled/Banned | ativar novamente; paraBannedcontacte o admin |
| 4 | Endereço do servidor | não consegue ligar | use o endereço e a porta exatos do link de reprodução, e ohttp/httpscerto |
| 5 | Número de ligações | expulso quando outra pessoa começa a ver | SEC-01,SEC-02 |
| 6 | IP bloqueado | nenhuma linha entra a partir dessa rede | SEC-08: espere que o bloqueio se levante ou peça ao admin que o levante |
| 7 | Bloqueio de ISP / país / Allowed IPs | só falha após mudar de rede, com dados móveis, com uma VPN ou em viagem | SEC-04,SEC-05,SEC-07 |
| 8 | Formato | o link HLS / TS é recusado | use um formato que o package permita (PLAY-03) |
| 9 | Aplicação bloqueada | falha só numa aplicação | experimente outra aplicação;SEC-09 |
FIX-02 O início de sessão funciona e a lista aparece, mas um canal não reproduz Espectador
FIX-03 Faltam canais ou grupos de canais Espectador
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.
FIX-04 Engasgos, bloqueios de imagem Espectador
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.
FIX-05 Sem guia de programação (EPG) Espectador
FIX-06 Não consigo criar uma linha
FIX-07 Descarregar uma playlist devolve o erro 429 ou uma página 404
FIX-08 Não consigo abrir uma página do dashboard
FIX-09 Não recebo e-mails do painel
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.
Glossário
- Linha (Line)
- a subscrição IPTV de um espectador: nome de utilizador, palavra-passe, expiração, bouquets, limites
- Utilizador (User)
- uma conta que inicia sessão no painel: admin, distribuidor, sub-distribuidor
- Grupo (Group)
- o grupo de permissões de uma conta do painel; decide menus, packages vendáveis, regras de linhas, testes
- Bouquet
- uma lista de conteúdo (canais, filmes, séries)
- Package
- o produto a vender: bouquets + duração + limites + preço em créditos
- Crédito (Credit)
- a unidade pré-paga usada para comprar packages
- Teste (Trial)
- o período de teste de um package
- Código de ativação
- um código com o qual um cliente ativa por si próprio uma linha paga
- MAG / Enigma2
- duas famílias de set-top boxes; iniciam sessão pelo endereço MAC
- Xtream Codes API
- o protocolo que a maioria das aplicações IPTV usa (servidor + nome de utilizador + palavra-passe)
- M3U / XMLTV
- formatos de ficheiro de uma playlist / de um guia de programação
- MPEG-TS / HLS
- dois formatos de stream
- EPG
- o guia de programação
- Catch-up
- ver um programa depois de ter sido emitido
- Restreamer
- uma linha para um parceiro que puxa streams para os redistribuir
- Conector (Connector)
- software que liga o sistema de loja de um distribuidor ao painel
- Webhook
- uma notificação que o painel envia ao sistema de um distribuidor quando algo acontece
Nenhuma pergunta corresponde
Experimente outra palavra-chave ou um código de pergunta, ou limpe o filtro.
Ainda sem solução?
Envie o nome de utilizador da linha (nunca a palavra-passe), quando aconteceu, a aplicação ou o dispositivo e o código da pergunta que já experimentou.