Xtream Codes API: o que é, como funciona o login e diferença para M3U

O fornecedor mandou três linhas: um endereço com dois pontos e um número no fim, um usuário e uma senha. Do outro lado, o cliente perguntou onde estava a lista. Não havia lista, e não precisava haver. Aquelas três linhas eram o login de um padrão que virou a língua comum entre painéis e reprodutores, e que quase ninguém sabe nomear.

A Xtream Codes API é esse padrão. O nome vem de um software de painel que dominou o mercado até 2019 e foi desligado numa operação policial na Europa, mas a forma de comunicação que ele criou sobreviveu: os painéis que vieram depois copiaram a interface, e os reprodutores continuaram falando com ela. Hoje, quando um app pede servidor, usuário e senha, é essa interface que está por trás.

Este texto mostra de onde vem o nome, o que o login entrega além dos canais e a diferença para a lista M3U. Mostra também quais reprodutores aceitam o formato, os avisos de erro mais comuns e como conferir as credenciais antes de assinar.

Aqui estão a origem do padrão, o que ele entrega, a comparação com a M3U e a tabela por tipo de acesso. Entram os reprodutores compatíveis, os avisos de erro e seus significados, as falhas de quem digita errado, a ordem para agir, os custos e as dúvidas mais frequentes.

Xtream Codes API: de onde vem o nome

Entre 2015 e 2019, o Xtream Codes foi o painel mais usado por quem revende canais online: um software que organiza canais, usuários, pagamentos e servidores. Em setembro de 2019, uma operação da polícia italiana com apoio de outros países desligou os servidores da empresa, e milhares de painéis pararam no mesmo dia, deixando revendedores e clientes sem sinal do nada.

A interface, porém, já estava incorporada nos reprodutores. Painéis novos passaram a oferecer a mesma estrutura para continuar compatíveis, e o nome ficou como sinônimo do padrão, mesmo sem a empresa original existir. É um caso raro de marca que sobreviveu ao próprio produto, e o nome segue nos menus dos aplicativos.

O que o login entrega

Com o login digitado, o reprodutor pergunta ao painel o que aquela conta pode ver e recebe de volta as categorias de canais ao vivo, o catálogo de filmes, as séries organizadas por temporada, o guia de programação e a data de vencimento da assinatura. Cada item vem com nome, ícone e descrição, e o app monta a interface a partir disso. Se o fornecedor renomear um canal ou incluir uma série, a mudança aparece na próxima abertura, sem baixar nada.

A lista M3U simples, por comparação, é um arquivo de texto com endereços de canais, um por linha, sem catálogo separado nem guia, a menos que o fornecedor inclua o link do guia à parte. Já o login pelo formato Xtream traz tudo junto e atualizado a cada abertura, sem arquivo para baixar nem link para renovar.

Quem popularizou esse formato entre usuários comuns foi o IPTV Smarters, que tem a tela de entrada com os três campos e organiza canais, filmes e séries em abas. Um teste IPTV Smarters costuma vir exatamente nesse formato, com os três dados para digitar, e é a forma mais rápida de ver se o painel do fornecedor responde bem, sem instalar mais nada. Guia carregando em segundos e catálogo aberto por categoria são sinais de painel bem configurado; lista sem guia e canais sem ícone indicam painel improvisado.

Comparativo por tipo de acesso

Reprodutores que aceitam o formato

Quase todos os reprodutores atuais de canais online têm a opção de login por API: os da família Smarters, os players para Android TV e caixinhas, os aplicativos de Samsung e LG e os de iPhone e iPad. Alguns chamam essa entrada de Xtream Codes, outros de API ou de login, mas os campos são os mesmos, e a ordem também.

Reprodutores genéricos de vídeo, como o VLC, não falam esse formato: para eles, o fornecedor gera a M3U a partir da mesma conta, num endereço que embute as credenciais.

Mensagens de erro e o que significam

Usuário ou senha inválidos indica credencial errada ou conta vencida. Servidor não responde aponta endereço digitado errado, porta faltando ou painel fora do ar. Conta expirada é o vencimento. Limite de conexões atingido significa que outro aparelho está usando a mesma conta. Cada mensagem tem uma causa, e a maioria se resolve conferindo os três campos, letra por letra, e a validade da assinatura. Quando tudo confere e o erro persiste, o problema está no painel, não na casa.

Falhas de quem digita errado

A falha mais comum é colar o servidor com espaço no fim ou sem a porta, o número que vem depois dos dois pontos. Vem depois trocar maiúsculas e minúsculas no usuário, que faz diferença em quase todo painel. Segue usar o endereço da M3U no campo de servidor, que espera só o domínio e a porta. Fecha a lista abrir o acesso em dois aparelhos ao mesmo tempo e receber o aviso de limite. Nenhuma dessas falhas é do serviço, e todas parecem ser, o que gera reclamação ao suporte por engano.

Em ordem, para agir

1. Separar as três informações: servidor com porta, usuário e senha, sem espaços.
2. No reprodutor, escolher a opção Xtream Codes ou API, não a de lista.
3. Digitar os campos e conferir se o guia e o catálogo carregam por categoria.
4. Se der erro, ler a mensagem: credencial, servidor, vencimento ou limite têm consertos diferentes.
5. Guardar as três linhas em local seguro, porque valem para qualquer reprodutor compatível.

O passo três é o que avalia o painel: guia e catálogo em segundos indicam servidor bem cuidado, e demora de um minuto indica o contrário.

Quanto custa

O formato não custa nada ao cliente: é a forma de o painel conversar com o app. Os reprodutores compatíveis são gratuitos na maioria, com versões pagas de R$ 20 a R$ 60 em compra única para tirar anúncios ou liberar recursos como gravação e multitela. A assinatura do serviço em si fica entre R$ 15 e R$ 40 por mês, com o acesso servindo em quantos reprodutores o cliente quiser, dentro do limite de telas.

Perguntas frequentes sobre o formato

Xtream Codes API ainda existe?

A empresa foi desligada em 2019; a interface continua em uso pelos painéis e reprodutores atuais, com o mesmo nome.

É melhor que a lista M3U?

Para o usuário, sim: traz guia, catálogo por categoria, séries por temporada e data de vencimento. A M3U serve para reprodutores genéricos e para quem prefere um arquivo único.

Posso usar o mesmo acesso em vários apps?

Pode, dentro do limite de telas do plano. As três linhas valem em qualquer reprodutor compatível, na TV, no celular ou no computador.

O que é a porta no servidor?

É o número depois dos dois pontos no endereço. Sem ela, o reprodutor não encontra o painel e devolve erro de servidor.

Como transformar o login em lista M3U?

Pedindo ao fornecedor, que gera o endereço da lista pelo mesmo cadastro, para uso em VLC e reprodutores sem entrada por API.

O login funciona no iPhone e na Samsung?

Funciona nos reprodutores dessas plataformas que têm a opção de login, o que inclui os mais usados.

Resumo

Xtream Codes API é o formato de login com servidor, usuário e senha herdado de um painel desligado em 2019 e mantido pelos painéis e reprodutores atuais. Ele entrega canais por categoria, catálogo de filmes, séries por temporada, guia e vencimento, o que a lista M3U simples não traz. Quase todo reprodutor moderno aceita a entrada por API, o VLC precisa da M3U gerada da mesma conta, e as mensagens de erro se resolvem conferindo porta, maiúsculas e vencimento. Guia rápido e catálogo por categoria no primeiro acesso são o sinal de painel bem cuidado.