A Xtream Codes API é uma forma de entregar IPTV baseada em credenciais: em vez de um único link de lista, introduz um URL de servidor, um nome de utilizador e uma palavra-passe, e a aplicação traz os seus canais, filmes, séries e guia de programação como listas organizadas, que se atualizam sozinhas. É a alternativa mais comum a uma lista M3U simples, e é a isto que a maioria dos leitores de IPTV modernos se refere quando fala em «Login with Xtream Codes». Este guia explica como funciona, em que difere do M3U e dos URL de portal, e como a usar em segurança.
O que é a Xtream Codes API
A Xtream Codes API começou por ser o software de painel que os fornecedores de IPTV usavam para gerir subscrições. A sua API — a forma como as aplicações falam com esse servidor — tornou-se uma norma de facto, pelo que hoje «Xtream Codes API» significa sobretudo o método de acesso que o seu leitor usa, mesmo quando o fornecedor tem outro software por trás.
O traço definidor é que se autentica com três informações:
- URL do servidor — o endereço do servidor do fornecedor, p. ex.
http://example.com:8080. - Nome de utilizador — o nome da sua conta.
- Palavra-passe — a chave da sua conta.
A partir daí, a aplicação pede tudo o resto. Nunca cola uma lista de canais gigante; é o servidor que entrega ao leitor dados estruturados a pedido.
Como funciona
Quando inicia sessão, o seu leitor de IPTV chama a API do servidor e recebe o serviço dividido em secções limpas:
- Autenticação. A aplicação envia o nome de utilizador e a palavra-passe para o URL do servidor e recebe de volta os dados da conta (estado, validade, ligações permitidas).
- Categorias de conteúdo. O servidor devolve a TV em direto, o VOD (filmes) e as séries como listas separadas e categorizadas — não num ficheiro plano único.
- Emissões a pedido. Quando abre um canal, a aplicação pede apenas essa emissão, por isso o carregamento é rápido.
- EPG. O guia de programação é entregue pela mesma API, de modo que o EPG fica alinhado com os seus canais sem precisar de um URL à parte.
Como as listas vivem no servidor, o fornecedor pode acrescentar ou retirar canais e a sua aplicação reflete isso na atualização seguinte — sem voltar a importar nada.
Xtream API vs. M3U vs. URL do portal
Estes três termos sobrepõem-se e confundem-se muitas vezes. Eis como se comparam:
| Lista M3U | Xtream Codes API | URL do portal (estilo MAG) | |
|---|---|---|---|
| O que introduz | Um URL ou ficheiro de lista | URL do servidor + utilizador + palavra-passe | URL do portal (ligado ao MAC do dispositivo) |
| Estrutura do conteúdo | Uma lista plana | Direto / VOD / Séries por categorias | Disposição do portal definida pelo fornecedor |
| EPG | URL de EPG separado | Integrado na API | Integrado no portal |
| Atualizações | Voltar a importar | Automáticas | Automáticas |
| Dispositivos típicos | Quase qualquer leitor | TiviMate, IPTV Smarters, etc. | Boxes MAG / emuladores de STB |
Em resumo: o M3U é o mais simples e universal, a Xtream Codes API é a mais organizada para aplicações, e um URL de portal é o estilo das boxes, associado ao endereço MAC do dispositivo. Muitos fornecedores oferecem os três a partir da mesma conta.
Bom saber: a maioria dos servidores Xtream também consegue devolver um link M3U se lhe acrescentar um caminho get.php — p. ex. http://server:port/get.php?username=USER&password=PASS&type=m3u_plus — para que um leitor que só aceita M3U consiga carregar os mesmos canais.
Como iniciar sessão
Iniciar sessão com a Xtream Codes leva menos de um minuto na maioria dos leitores:
- Escolha um leitor compatível, como o TiviMate ou o IPTV Smarters — veja o nosso guia dos melhores leitores de IPTV.
- Escolha «Login with Xtream Codes» (por vezes «Xtream Codes API» ou «Add Playlist → Xtream»).
- Introduza os três campos — URL do servidor, nome de utilizador, palavra-passe — exatamente como o fornecedor lhos deu, incluindo o número da porta.
- Espere pelo carregamento. A aplicação traz a TV em direto, o VOD, as séries e o EPG automaticamente.
- Organize. Esconda as categorias que não usa e reordene os favoritos; a maioria dos leitores guarda isto por perfil.
Para um percurso completo na aplicação, siga o nosso guia de instalação do TiviMate.
É legal?
O protocolo Xtream Codes API é legal — é um método de entrega, tal como o M3U. O que conta é o fornecedor por trás das credenciais.
- Legal: credenciais de um serviço que detém os direitos dos canais que transmite.
- Ilegal: acessos baratos de «todos os canais», vendidos sem quaisquer direitos, por muito bem acabada que a aplicação pareça.
Aviso: um acesso Xtream bem apresentado não torna um serviço legítimo. Aplicam-se os mesmos sinais de alarme de qualquer IPTV — todos os canais premium por uns poucos euros, pagamento por cartão-presente ou criptomoeda e nenhuma empresa real. A WatchlyGuide só cobre fontes licenciadas.
Em resumo
A Xtream Codes API é simplesmente uma forma mais arrumada de entrar no seu IPTV: três campos — URL do servidor, nome de utilizador e palavra-passe — que carregam a TV em direto, os filmes, as séries e o guia como secções organizadas, que se atualizam sozinhas. É mais estruturada do que um M3U plano e diferente de um URL de portal MAG, ainda que muitas contas suportem os três. Use um leitor compatível, introduza os dados exatamente como os recebeu e só com um fornecedor que detenha os direitos devidos.
A seguir, compare-a com o formato de lista M3U, ou comece pelos fundamentos com o que é o IPTV e como funciona realmente o streaming.
Ficou com dúvidas sobre algum termo desta página? Procure-o no glossário de streaming.