{
"user_info": {
"username": "demo_user",
"password": "demo_pass",
"auth": 1,
"status": "Active",
"exp_date": "1775000000",
"is_trial": "0",
"active_cons": "0",
"max_connections": "2",
"created_at": "1700000000",
"allowed_output_formats": [
"m3u8",
"ts",
"mp4",
"mkv"
]
},
"server_info": {
"url": "stream.example.com",
"port": "8080",
"https_port": "8443",
"server_protocol": "https",
"rtmp_port": "8880",
"timezone": "UTC",
"timestamp_now": 1714000000,
"time_now": "2026-10-26 10:00:00"
}
}
Référence API technique
Exigences Xtream Codes player_api.php
Consultez les schémas de données, le protocole d'authentification et les réponses de catalogue attendus par Mayk IP TV.
Authentification et informations serveur
La requête GET /player_api.php transmet les blocs user_info et server_info en JSON. L'authentification valide requiert user_info.auth = 1 et le statut 'Active'.
Six actions de catalogue fondamentales
Mayk IP TV interroge get_live_categories, get_vod_categories, get_series_categories, ainsi que get_live_streams, get_vod_streams et get_series. Les listes vides doivent retourner [].
Intégrité des catégories et éléments orphelins
Chaque flux et série doit pointer vers un category_id existant dans la réponse des catégories. Les identifiants inexistants entraînent la disparition d'éléments.
Métadonnées de série et cartographie des épisodes
Les détails sont obtenus via get_series_info&series_id=.... La réponse doit comporter un dictionnaire episodes indexé par numéro de saison.
URL de lecture et prise en charge des plages d'octets
Les flux utilisent les modèles /live/, /movie/ et /series/. Les serveurs VOD et séries doivent supporter HTTP 206 Partial Content pour l'avance rapide.
Champs d'authentification
| Champ / Balise | Niveau | Type | Exemple | Description |
|---|---|---|---|---|
user_info.auth | Requis | Integer (1 = success) | 1 | Code numérique d'authentification : la valeur 1 confirme la validité du compte. |
user_info.status | Requis | String ("Active") | "Active" | État du compte d'abonnement ; doit être 'Active' pour la lecture. |
user_info.exp_date | Requis | Unix Timestamp / null | "1775000000" | Date d'expiration en secondes Unix, ou null pour un accès illimité. |
user_info.max_connections | Requis | String / Integer | "2" | Nombre maximal de connexions simultanées autorisées. |
user_info.allowed_output_formats | Requis | Array of String | ["m3u8", "ts"] | Formats de conteneur supportés par le serveur (m3u8, ts, mp4, mkv). |
server_info | Requis | Object | {"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"} | Objet contenant les paramètres du serveur, ports et protocole. |
Actions et points de terminaison
| Champ / Balise | Niveau | Type | Exemple | Description |
|---|---|---|---|---|
get_live_categories | Requis | Array of Category Objects | [{"category_id":"1","category_name":"News","parent_id":0}] | Action retournant la liste des catégories de télévision en direct. |
get_vod_categories | Requis | Array of Category Objects | [{"category_id":"10","category_name":"Action","parent_id":0}] | Action retournant la liste des catégories de films à la demande. |
get_series_categories | Requis | Array of Category Objects | [{"category_id":"20","category_name":"Drama","parent_id":0}] | Action retournant la liste des catégories de séries télévisées. |
get_live_streams | Requis | Array of Live Stream Objects | [{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}] | Action retournant toutes les chaînes en direct ou filtrées par catégorie. |
get_vod_streams | Requis | Array of VOD Stream Objects | [{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}] | Action retournant tous les films à la demande ou filtrés par catégorie. |
get_series | Requis | Array of Series Objects | [{"series_id":303,"name":"Example Series","category_id":"20"}] | Action retournant l'aperçu général des séries télévisées. |
get_series_info | Requis | Series Detail Object (episodes map) | {"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}} | Action détaillée retournant les saisons et la liste des épisodes. |
Champs de données Live et VOD
| Champ / Balise | Niveau | Type | Exemple | Description |
|---|---|---|---|---|
stream_id | Requis | Integer / String | 101 | Identifiant unique numérique ou chaîne pour les flux en direct et films. |
name | Requis | String | "TRT 1 HD" | Titre d'affichage de la chaîne ou du film à la demande. |
stream_type | Requis | String ("live" | "movie") | "live" | Type de flux : 'live' pour la TV en direct, 'movie' pour la VOD. |
stream_icon | Optionnel | URL (http/https) | "https://stream.example.com:8080/images/101.png" | URL directe HTTP/HTTPS vers le logo de la chaîne ou l'affiche du film. |
category_id | Requis | String / Integer | "1" | Identifiant de catégorie correspondant à une catégorie valide. |
container_extension | Requis | String without dot ("mp4", "mkv", "m3u8") | "mp4" | Extension de conteneur cible sans point initial (mp4, mkv, m3u8). |
is_adult | Optionnel | Integer / String ("0" | "1") | "0" | Indicateur de contenu adulte : '1' signale du matériel pour adultes. |
Champs de séries et épisodes
| Champ / Balise | Niveau | Type | Exemple | Description |
|---|---|---|---|---|
series_id | Requis | Integer / String | 303 | Identifiant unique de la fiche de série télévisée. |
name | Requis | String | "Example Series" | Titre canonique de la série télévisée. |
cover | Optionnel | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | URL directe HTTP/HTTPS de l'affiche de la série. |
category_id | Requis | String / Integer | "20" | Identifiant de catégorie existant dans les catégories de séries. |
season | Requis | Integer / String | 1 | Numéro de saison contenant l'épisode concerné. |
episode_num | Requis | Integer / String | 1 | Numéro d'ordre de l'épisode dans la saison. |
container_extension | Requis | String without dot ("mp4", "mkv") | "mp4" | Extension de fichier vidéo sans point initial pour l'épisode. |
Modèles d'URL de flux
| Type | Champ / Balise | Exemple |
|---|---|---|
| TV en direct | {server}/live/{username}/{password}/{stream_id}.m3u8 | https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8 |
| Film (VOD) | {server}/movie/{username}/{password}/{stream_id}.{container_extension} | https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4 |
| Épisode de série | {server}/series/{username}/{password}/{episode_id}.{container_extension} | https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4 |
Modèles d'exemple
[
{
"num": 1,
"name": "TRT 1 HD",
"stream_type": "live",
"stream_id": 101,
"stream_icon": "https://stream.example.com:8080/images/101.png",
"epg_channel_id": "trt1.tr",
"added": "1700000000",
"category_id": "1",
"custom_sid": null,
"tv_archive": 1,
"direct_source": "",
"tv_archive_duration": 3
},
{
"num": 2,
"name": "Example Movie (2026)",
"stream_type": "movie",
"stream_id": 202,
"stream_icon": "https://stream.example.com:8080/images/202.png",
"category_id": "10",
"container_extension": "mp4",
"rating": "8.4",
"year": "2026"
}
]
{
"seasons": [
{
"air_date": "2026-01-01",
"episode_count": 10,
"id": 1,
"name": "Season 1",
"overview": "First season overview",
"season_number": 1,
"cover": "https://stream.example.com:8080/images/season1.png"
}
],
"info": {
"name": "Example Series",
"cover": "https://stream.example.com:8080/images/series303.png",
"plot": "Series plot description",
"cast": "Actor One, Actor Two",
"director": "Director Name",
"genre": "Drama",
"releaseDate": "2026-01-01",
"rating": "8.7",
"category_id": "20"
},
"episodes": {
"1": [
{
"id": "30301",
"episode_num": 1,
"title": "Pilot",
"container_extension": "mp4",
"info": {
"duration_secs": 2700,
"duration": "00:45:00",
"video": {},
"audio": {},
"bitrate": 4500
},
"season": 1
}
]
}
}
Vérificateur de format interactif
Collez votre extrait M3U ou réponse JSON Xtream ci-dessous pour vérifier sa conformité avec Mayk IP TV.
Liste de contrôle de compatibilité Xtream
- Renvoyez user_info.auth = 1 et status = Active lorsque les accès sont bons.
- Renvoyez un tableau JSON vide [] plutôt que null pour les listes vides.
- Vérifiez que chaque category_id correspond à une catégorie existante.
- Transmettez container_extension sans point initial (ex. mp4, mkv).
- Assurez le support de HTTP 206 Partial Content pour la navigation vidéo.