L'API Xtream Codes est la manière dont la plupart des services IPTV permettent à une application de dialoguer avec leur serveur. Quand votre service vous remet une URL de serveur, un nom d'utilisateur et un mot de passe, il vous donne accès à cette API : le lecteur envoie vos identifiants au serveur, qui répond avec l'état de votre abonnement, vos catégories et chaînes en direct, vos films, vos séries et le guide TV. Qu'est-ce que l'API Xtream Codes, concrètement ? Un langage commun entre serveurs IPTV et lecteurs — c'est pour cela qu'un même code Xtream fonctionne dans des applications différentes. Ce guide explique ce qu'elle contient, comment un lecteur l'utilise, ce qui la distingue d'un lien M3U et ce que cela change pour vous.
Klyvo Play est un lecteur. Il ne fournit aucune chaîne, aucun film ni aucune série : vous y connectez le service que vous avez déjà et que vous êtes autorisé à utiliser, avec ses identifiants Xtream ou son lien M3U.
Qu'est-ce que l'API Xtream Codes, et d'où vient son nom ?
Xtream Codes était à l'origine le nom d'un logiciel de gestion de serveurs IPTV. Le produit d'origine n'est plus développé, mais la façon dont il présentait le contenu aux applications est devenue un standard de fait : de nombreux panneaux de gestion parlent aujourd'hui la même API. D'où l'expression compatible Xtream employée par les services, et l'habitude d'appeler « code Xtream » les identifiants eux-mêmes.
Pour vous, l'histoire compte peu. Ce qui compte, c'est qu'un accès Xtream est structuré : au lieu d'une simple liste d'adresses, le lecteur peut poser au serveur des questions précises et recevoir des réponses organisées.
Les trois champs d'un code Xtream
- URL du serveur : l'adresse du serveur de votre service, en général avec un port, par exemple http://serveur.exemple:8080. Inutile d'ajouter un chemin de page derrière.
- Nom d'utilisateur : votre identifiant personnel sur ce serveur.
- Mot de passe : le secret qui l'accompagne.
Saisissez-les exactement comme votre service vous les a envoyés : majuscules et minuscules comptent, et un port oublié ou une espace en trop sont les causes les plus fréquentes de refus. Si vous collez une adresse qui se termine par player_api.php ou get.php, Klyvo Play retire cette fin et garde l'adresse du serveur. La marche à suivre appareil par appareil est dans comment entrer un code Xtream.
Comment un lecteur dialogue avec un serveur Xtream
Tout part d'une adresse sur le serveur : player_api.php, appelée avec votre nom d'utilisateur et votre mot de passe. La première réponse décrit votre compte et le serveur :
- Les informations du compte : ligne active ou non, date d'expiration, nombre de connexions simultanées autorisées et nombre de connexions en cours.
- Les informations du serveur : son adresse, ses ports et son fuseau horaire, importants pour le guide et le replay.
Le lecteur demande ensuite le catalogue au moyen d'actions nommées. Les principales :
- get_live_categories et get_live_streams : les bouquets du direct, puis les chaînes de chaque bouquet, avec leur logo, leur identifiant de guide et la présence ou non d'une archive.
- get_vod_categories, get_vod_streams et get_vod_info : les catégories de films, les films de chacune, puis la fiche d'un film (résumé, distribution, durée, format du fichier).
- get_series_categories, get_series et get_series_info : les séries, puis leurs saisons et épisodes.
- get_short_epg et get_simple_data_table : les programmes d'une chaîne — ce qui passe maintenant et ensuite, et les programmes passés utilisés pour le replay.
Les réponses arrivent en JSON, un format texte structuré que les applications lisent facilement. Comme chaque catégorie et chaque titre a un identifiant, le lecteur peut ne charger que ce que vous ouvrez, au lieu de télécharger tout le catalogue d'un coup.
Comment chaque flux est adressé
Une fois l'identifiant d'une chaîne ou d'un film connu, le lecteur construit l'adresse du flux sur le même serveur, avec vos identifiants dedans :
- Chaînes en direct : /live/utilisateur/motdepasse/id, suivi de .ts (MPEG-TS) ou .m3u8 (HLS).
- Films : /movie/utilisateur/motdepasse/id, suivi de l'extension du fichier, par exemple .mp4 ou .mkv.
- Épisodes : /series/utilisateur/motdepasse/id, avec l'extension de l'épisode.
- Replay : /timeshift/utilisateur/motdepasse/durée/début/id, pour un programme déjà diffusé.
Deux autres adresses complètent l'ensemble : get.php, qui produit la même ligne sous forme de playlist M3U, et xmltv.php, qui produit le guide TV au format XMLTV — voir ce que sont l'EPG et le XMLTV.
API Xtream Codes ou lien M3U ?
Un lien M3U est une playlist : une liste texte de noms de chaînes et d'adresses. Un lien M3U get.php d'un service compatible Xtream contient les mêmes serveur, identifiant et mot de passe que le code Xtream. Mais l'API, utilisée directement par le lecteur, est plus riche :
- Un catalogue organisé : direct, films et séries arrivent séparément, chacun avec ses catégories.
- Des fiches à la demande : résumé, saisons et épisodes sont chargés quand vous ouvrez un titre.
- Guide et replay par chaîne : le serveur indique quelles chaînes ont une archive et envoie leurs programmes.
- L'état de l'abonnement : date d'expiration et nombre de connexions sont connus, et le lecteur peut vous dire qu'une ligne a expiré au lieu d'afficher une erreur vague.
Klyvo Play accepte les deux. Quand vous collez un lien M3U get.php, l'application y lit le serveur et les identifiants, puis travaille avec la même API : vous obtenez le même catalogue dans les deux cas. La comparaison complète est dans connexion Xtream ou lien M3U.
Comment Klyvo Play utilise l'API Xtream
- En direct avec votre service : l'application demande le catalogue au serveur de votre service, et les flux voyagent de ce serveur jusqu'à votre appareil.
- Bouquet par bouquet : les chaînes se chargent quand vous ouvrez leur catégorie, ce qui garde un premier écran rapide même avec une très grosse playlist — voir gérer une grosse playlist.
- L'état de la ligne : une ligne expirée est affichée comme telle, et un refus du serveur de votre service apparaît avec son code, pour savoir qui contacter — voir l'état de la ligne.
- Plusieurs playlists : vous pouvez garder plusieurs codes Xtream sur un appareil et passer de l'un à l'autre dans Mes playlists.
- Des identifiants chiffrés, jamais réaffichés en entier une fois enregistrés.
Vous pouvez même éviter toute saisie : chaque installation de Klyvo Play affiche un code qui ressemble à une adresse MAC et une Device Key. Votre revendeur, ou vous-même, pouvez associer la playlist à ces codes sur le portail client, et l'application la récupère — voir le portail des appareils.
Les bons réflexes avec votre code Xtream
- Gardez-le pour vous. Votre identifiant et votre mot de passe figurent dans chaque adresse de flux ; qui les possède peut utiliser vos connexions.
- Respectez la limite de connexions. Si votre abonnement n'autorise qu'un flux à la fois, un second appareil sur le même code sera refusé ou coupera le premier.
- Utilisez l'adresse fournie par votre service, avec http ou https et le port.
- Vérifiez la date d'expiration auprès de votre service quand tout s'arrête d'un coup : c'est en général la ligne, pas l'application.
Questions fréquentes
L'API Xtream Codes est-elle légale ? C'est une interface technique, utilisée par de nombreux panneaux de serveurs. La légalité dépend du contenu diffusé par un service et de ses droits, pas de l'API ni du lecteur.
Puis-je utiliser mon code Xtream dans plusieurs applications ? En général oui : le format est partagé. Chaque application compte comme une connexion pendant la lecture, dans la limite de votre abonnement.
Pourquoi mon code Xtream est-il refusé ? Le plus souvent : une faute de frappe, un port manquant, une ligne expirée ou un serveur qui refuse l'application. Klyvo Play affiche la raison reçue, par exemple une ligne expirée ou un code de refus.
Ai-je besoin d'un code Xtream si j'ai un lien M3U ? Non. Un lien M3U get.php d'un service compatible Xtream contient les mêmes identifiants, et Klyvo Play sait le lire.
Klyvo Play fournit-il un code Xtream ? Non. Le code vient du service auquel vous êtes abonné ; Klyvo Play est le lecteur.
Connectez votre code Xtream
L'API Xtream Codes transforme trois champs courts en un catalogue complet : direct, films, séries, guide et replay. Si vous avez un code Xtream d'un service que vous êtes autorisé à utiliser, téléchargez Klyvo Play sur vos appareils, saisissez l'URL du serveur, l'identifiant et le mot de passe, et essayez l'application complète gratuitement pendant 10 jours.