Configuração
Xtream Codes explicados: servidor, nome de usuário e senha
Xtream Codes IPTV explicado de forma simples: diferenças em relação ao M3U, campos de servidor, usuário e senha, portas e como funciona a conexão por API.
O termo “Xtream” aparece bastante em e-mails de ativação de IPTV, mas o funcionamento técnico raramente é explicado com clareza. Este guia esclarece o que são as credenciais Xtream Codes, em que elas diferem de um URL M3U e a que corresponde cada campo pedido pelo aplicativo.
De onde vem o termo Xtream Codes?
Xtream Codes designava originalmente um painel de gerenciamento usado por alguns provedores de IPTV para administrar seus servidores. Hoje, no uso comum, “conexão Xtream Codes” ou “API Xtream Codes” se refere simplesmente a um método de conexão estruturado, no qual o aplicativo se comunica com o servidor por uma interface de programação de aplicações (API), em vez de baixar um simples arquivo de texto. De modo geral, uma API é uma interface que permite a dois programas trocar dados de forma estruturada, como lembra a definição da Wikipédia.
Quais são os três campos a preencher no Xtream Codes?
Uma conexão Xtream Codes pede sempre três dados: o endereço do servidor (com a porta), o nome de usuário e a senha. Os três são fornecidos por e-mail na ativação, como mostra o diagrama acima:
| Campo | Função | Exemplo de formato |
|---|---|---|
| Endereço do servidor | URL do servidor IPTV, com a porta | http://exemplo-servidor.com:8080 |
| Nome de usuário | Identificador único associado à sua assinatura | Fornecido por e-mail |
| Senha | Chave associada a esse identificador | Fornecida por e-mail |
O endereço do servidor normalmente inclui um número de porta, depois de dois pontos, como em :8080. Esse número faz parte do endereço e deve ser copiado exatamente, sem ser omitido. Um erro comum é inserir só o nome de domínio sem a porta, o que impede a conexão.
O que o aplicativo obtém depois da conexão?
Depois de validar os três campos, o aplicativo consulta o servidor via API e exibe o catálogo já organizado em seções separadas. Ele pode mostrar:
- a TV ao vivo (canais em tempo real, organizados por categorias);
- o vídeo sob demanda (VOD) (filmes e séries sob demanda);
- o EPG (guia de programação), quando o servidor oferece esse dado.
Essa separação automática em seções distintas é a diferença mais visível entre uma conexão Xtream Codes e uma simples lista M3U, na qual tudo costuma aparecer em uma única lista, conforme a organização do próprio player. Aplicativos como o TiviMate ou o IPTV Smarters Pro aproveitam ao máximo essa estrutura pela tela dedicada de login “Xtream Codes API”.
Xtream Codes ou M3U: qual é a diferença?
A diferença não está na qualidade da transmissão de vídeo, que é igual nos dois casos por se tratar da mesma assinatura. Ela está no método de conexão e na organização do catálogo:
- O M3U transmite um único URL que o player interpreta como uma lista, conforme a estrutura descrita no nosso artigo sobre a anatomia de um arquivo M3U.
- O Xtream Codes usa três credenciais separadas e permite ao aplicativo consultar o servidor para organizar dinamicamente a TV ao vivo, o VOD e o EPG.
O formato M3U continua com uma compatibilidade mais universal, inclusive com players simples que não têm nenhuma tela dedicada de conexão IPTV, como documenta a página de referência do formato na Wikipédia. Nossa comparação entre M3U e Xtream Codes explica como escolher entre os dois conforme o aplicativo.
O que fazer se houver um erro de conexão?
Os erros mais comuns vêm de um deslize em um dos três campos, principalmente em aparelhos móveis, onde copiar e colar pode acrescentar um caractere invisível. Confira primeiro que servidor, usuário e senha estão exatos. Se a conexão falhar mesmo depois de conferir tudo com cuidado, a conta pode ter expirado ou o número de conexões simultâneas incluídas no plano pode ter sido ultrapassado, um ponto explicado na nossa página de preços. Nosso artigo dedicado aos erros de autenticação do Xtream Codes mostra cada código de erro e a causa mais provável.
Em resumo
O Xtream Codes é um método de conexão IPTV por API que usa três campos (servidor, nome de usuário e senha) para exibir um catálogo organizado em seções distintas. Ele não substitui tecnicamente o formato M3U, mas oferece uma navegação mais estruturada quando o aplicativo é compatível. Veja nossas perguntas frequentes para esclarecer outras dúvidas comuns de configuração.
Perguntas frequentes
O que é exatamente uma conexão Xtream Codes?
É um método de conexão estruturado: o aplicativo se conecta a um servidor por uma API, usando um endereço de servidor, um nome de usuário e uma senha, em vez de apenas um URL de lista de reprodução. Em seguida, ele busca e organiza a TV ao vivo, o VOD e o EPG.
Onde encontro os meus dados de Xtream Codes?
Eles costumam ser enviados por e-mail quando você ativa a assinatura: um endereço de servidor (URL com número de porta), um nome de usuário e uma senha. Guarde esse e-mail, pois você vai precisar dele em cada nova instalação.
O que significa o número da porta no endereço do servidor?
A porta faz parte do endereço de rede do servidor e indica o canal específico em que a conexão é feita (em geral 80, 8080 ou um número personalizado). O número deve ser copiado exatamente como foi fornecido, sem omitir nem alterar.
Os códigos Xtream são mais confiáveis do que os M3U?
Nenhum dos métodos é mais confiável por si só: a estabilidade depende do servidor, da rede e do aplicativo, e não do protocolo de conexão. A principal vantagem do Xtream Codes é oferecer uma organização mais estruturada do catálogo quando o aplicativo é compatível.
O que fazer se aparecer um erro de autenticação do Xtream Codes?
Comece confirmando que o servidor, o nome de usuário e a senha foram copiados sem espaços nem caracteres invisíveis, principalmente no celular. Se o erro continuar, a conta pode ter expirado ou o número de conexões simultâneas permitidas pode ter sido ultrapassado.
Dá para usar códigos Xtream sem um aplicativo dedicado?
Alguns players genéricos conseguem, às vezes, remontar um URL M3U equivalente a partir das credenciais Xtream Codes, mas o método é feito principalmente para aplicativos que oferecem uma tela de login “API Xtream Codes”.
