L'API Xtream Codes est devenue la façon la plus courante de connecter une application IPTV à un serveur. Si vous avez déjà configuré un lecteur en choisissant « Xtream Codes API » au lieu de coller une URL M3U, vous l'avez utilisée sans forcément savoir ce qui se passait en coulisses. Ce guide explique, de façon purement technique, ce qu'est le protocole, comment il fonctionne et en quoi il diffère d'une simple liste — sans générateur ni code miracle, parce que ça n'existe pas.
Découvrez les offres et les prix sur notre page abonnements IPTV.
Qu'est-ce que l'API Xtream Codes ?
À l'origine, « Xtream Codes » était le nom d'un logiciel de gestion de panneau IPTV. Le logiciel a disparu, mais son interface applicative (API) est restée un standard de fait : la plupart des serveurs exposent aujourd'hui les mêmes points d'entrée, et la plupart des lecteurs savent les interroger. C'est pour ça qu'on parle indifféremment d'API Xtream Codes ou de Xtream Codes API : il s'agit du même protocole côté serveur.
Concrètement, l'API est une porte d'entrée normalisée. L'application envoie une requête avec vos identifiants ; le serveur répond en JSON avec la liste des chaînes, les catégories, la vidéo à la demande et les données du guide des programmes. Rien n'est stocké en dur dans l'application : tout est chargé à la demande, ce qui garde le contenu à jour.
Comment fonctionne l'API Xtream Codes
Le protocole repose sur quelques points d'entrée bien connus, tous situés à la racine du portail de votre fournisseur :
- player_api.php — le cœur de l'API. Avec ?username=…&password=…, il authentifie le compte et renvoie les informations générales (statut de l'abonnement, date d'expiration, connexions autorisées), puis, avec des actions comme get_live_categories ou get_vod_streams, la structure complète du contenu.
- get.php — génère à la volée une liste M3U équivalente (type=m3u_plus). C'est le pont entre l'API et le format M3U classique.
- xmltv.php — fournit le guide des programmes (EPG) au format XMLTV, affiché à côté de chaque chaîne.
Le principe est toujours le même : trois informations (URL du portail, utilisateur, mot de passe), une authentification, puis un catalogue renvoyé en direct. C'est cette mécanique qui permet à une application d'afficher des catégories propres, une recherche, des favoris et un EPG là où un fichier M3U seul reste une longue liste plate.
API Xtream Codes ou liste M3U : que choisir ?
Les deux méthodes s'appuient sur le même abonnement ; elles diffèrent surtout par le confort. Pour tout comprendre du format, lisez aussi notre guide Xtream Codes IPTV expliqué.
| Critère | API Xtream Codes | Liste M3U |
|---|---|---|
| Chargement | Dynamique, à la demande | Fichier statique |
| Catégories | Oui, structurées | Selon le fichier |
| EPG intégré | Oui (via xmltv.php) | Rarement propre |
| Mise à jour | Automatique | Manuelle |
En pratique, si votre application propose le mode Xtream Codes, c'est presque toujours le meilleur choix : vous saisissez trois champs une seule fois et le reste se met à jour tout seul. La liste M3U reste utile pour un test rapide dans un lecteur comme VLC.
Quelles applications utilisent l'API Xtream Codes ?
La compatibilité est large : la plupart des lecteurs modernes proposent une option « Xtream Codes API » ou « Xtream Login » à la configuration. La démarche est identique partout : choisir ce mode, entrer l'URL du portail, l'utilisateur et le mot de passe fournis par votre prestataire, puis valider. L'application se charge du reste. Pour comparer les lecteurs compatibles, voyez notre guide de la meilleure application IPTV.
Sécurité et bonnes pratiques
L'API est neutre, mais vos identifiants ne le sont pas : ils donnent accès à votre compte. Quelques règles simples :
- Ne partagez jamais votre URL de portail et vos identifiants : la plupart des abonnements limitent les connexions simultanées, et un partage large fait tomber le flux pour tout le monde.
- Méfiez-vous des sites qui promettent des identifiants gratuits ou un « générateur » : un accès Xtream correspond à un compte réel, il ne se fabrique pas. Ces codes sont expirés, partagés en masse ou piégés.
- Privilégiez un fournisseur qui vous remet vos propres accès et assure un serveur stable aux heures de pointe.
C'est exactement la logique d'un abonnement IPTVPIX : vous recevez vos identifiants Xtream Codes, vous les saisissez dans l'application de votre choix, et vous gardez un flux propre sans bidouille.
