Qu’est-ce que l’API Xtream Codes ?
Xtream Codes est un protocole API utilisé par les fournisseurs IPTV pour diffuser la TV en direct, la vidéo à la demande et les séries TV vers des applications de lecture compatibles. Au lieu de charger une seule URL comme avec M3U, vous entrez trois identifiants séparés : une URL de serveur, un nom d’utilisateur et un mot de passe.
L’API communique directement avec le serveur IPTV, ce qui donne à votre application un accès en temps réel aux mises à jour des chaînes, aux données EPG, à la TV en rattrapage et aux catégories de contenu — le tout sans avoir besoin de rafraîchir ou de re-saisir les URL.
Xtream Codes vs M3U : lequel choisir ?
Les deux méthodes vous connectent aux mêmes chaînes, mais elles diffèrent en termes de fonctionnalités et de compatibilité avec les applications :
Avantages de Xtream Codes :
- Intégration EPG automatique sans URL de guide séparée
- Support intégré du rattrapage et du décalage temporel
- Catégories organisées pour la TV en direct, les films et les séries
- Chargement plus rapide des chaînes car l’application interroge le serveur directement
- Mises à jour automatiques lorsque de nouvelles chaînes sont ajoutées
Avantages de M3U :
- Fonctionne avec un plus grand nombre d’applications et d’appareils
- Compatible avec VLC, Kodi et d’autres lecteurs multimédia généraux
- Configuration plus simple — une seule URL à coller
Configuration Xtream Codes étape par étape
Suivez ces étapes pour vous connecter via Xtream Codes sur toute application IPTV compatible :
Localiser vos identifiants
Après vous être abonné à SecureOnePlan, vérifiez votre e-mail pour trois informations : l’URL du serveur (ex. http://fournisseur.com:port), votre nom d’utilisateur et votre mot de passe.
Ouvrir votre application IPTV
Lancez votre application IPTV préférée (TiviMate, Smarters Pro, IBO Player, etc.) et cherchez l’option pour ajouter une nouvelle playlist ou un nouveau fournisseur.
Sélectionner Xtream Codes API
Choisissez « Xtream Codes » ou « Xtream Codes API » comme méthode de connexion. Ne sélectionnez pas URL M3U — ce sont deux écrans de saisie différents.
Entrer vos identifiants
Tapez ou collez votre URL de serveur, nom d’utilisateur et mot de passe dans les champs correspondants. Assurez-vous que l’URL du serveur inclut le numéro de port (les chiffres après les deux-points).
Se connecter et charger les chaînes
Appuyez sur « Connexion » ou « Ajouter ». L’application se connectera au serveur et chargera votre liste de chaînes, bibliothèque VOD et catalogue de séries. Cela peut prendre 30 à 90 secondes au premier chargement.
Meilleures applications pour la connexion Xtream Codes
Ces applications offrent la meilleure expérience lors de la connexion via l’API Xtream Codes :
TiviMate
Le lecteur IPTV le plus soigné avec un support complet de Xtream Codes. Grille EPG élégante, favoris, enregistrement et vue multi-écran. Version Premium recommandée pour les playlists multiples.
IPTV Smarters Pro
Application multiplateforme avec connexion Xtream Codes native. Organise automatiquement le contenu en onglets TV en direct, Films et Séries. Version gratuite disponible avec toutes les fonctionnalités essentielles.
IBO Player / IBO Pro
Lecteur léger populaire sur les TV Samsung et LG. Support Xtream Codes avec un système d’activation par appareil. Excellent pour les utilisateurs de Smart TV.
XCIPTV Player
Lecteur Android riche en fonctionnalités avec support Xtream Codes, EPG intégré, TV en rattrapage et contrôle parental. Gratuit avec fonctionnalités premium optionnelles.
Paramètres avancés Xtream Codes
Une fois connecté, ces paramètres peuvent améliorer votre expérience de visionnage :
User Agent : Certaines applications vous permettent de définir une chaîne user agent personnalisée. Si les flux ne se lisent pas, essayez de changer le user agent pour une chaîne de navigateur courante ou laissez-le par défaut.
Format de flux : Vous pouvez souvent choisir entre MPEG-TS (.ts) et HLS (.m3u8). Utilisez TS pour la plupart des appareils Android et HLS pour les appareils Apple et les lecteurs web.
Décalage EPG : Si votre guide des programmes affiche des horaires incorrects, ajustez le paramètre de décalage EPG. Celui-ci est généralement mesuré en heures et corrige les différences de fuseau horaire.
Taille du tampon : Dans des applications comme TiviMate, vous pouvez ajuster la taille du tampon dans les paramètres du lecteur. Augmenter le tampon à 3-5 secondes peut réduire les interruptions de lecture sur les connexions plus lentes.
Dépannage des problèmes de connexion Xtream Codes
Si vous ne parvenez pas à vous connecter ou si les chaînes ne se chargent pas, suivez ces étapes de dépannage :
Erreur « Serveur introuvable » : Vérifiez que l’URL du serveur est correcte, y compris le protocole (http ou https) et le numéro de port. Essayez d’accéder à l’URL dans un navigateur web — vous devriez voir une page de réponse du serveur.
Erreur « Échec d’authentification » : Revérifiez votre nom d’utilisateur et mot de passe. Ils sont sensibles à la casse. Copiez-les et collez-les directement depuis votre e-mail de bienvenue SecureOnePlan pour éviter les fautes de frappe.
Les chaînes se chargent mais ne se lisent pas : Votre FAI bloque peut-être le trafic IPTV. Essayez de vous connecter via un VPN pour contourner un éventuel bridage. Essayez également de changer le format de sortie du flux dans les paramètres de l’application.
L’application se fige pendant la connexion : Videz le cache et les données de l’application, puis réessayez. Sur Firestick, allez dans Paramètres > Applications > Gérer les applications installées > sélectionnez votre application > Vider le cache.
Seule la TV en direct se charge, pas le VOD : Cela peut arriver si le serveur est temporairement surchargé. Attendez quelques minutes et rechargez la playlist. Si le problème persiste, contactez le support SecureOnePlan.