{
"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"
}
}
Technische documentatie
Xtream Codes IPTV API-formaatspecificatie
Technische specificatie van de Xtream Codes IPTV API. Eindpunten voor authenticatie, categorieën, live streams, VOD, series en interactieve JSON-validatie.
Architectuur van de Xtream Codes API
De Xtream Codes API is het toonaangevende REST-protocol voor IPTV-providers, waarmee spelers op een gestructureerde manier authenticatie en catalogi opvragen.
Authenticatieworkflow
Spelers verifiëren gebruikersgegevens via het player_api.php-eindpunt met gebruikersnaam en wachtwoord, waarna abonnementsstatus en serverparameters worden geretourneerd.
Catalogusacties en metadata
Aparte actieparameters maken het mogelijk om categorieën en stromen voor live televisie, video on demand en series efficiënt en gescheiden op te halen.
Uniforme URL-structuur
Stream-URL's volgen een gestandaardiseerde opbouw voor live-uitzendingen, films en afzonderlijke serie-afleveringen met passende containerformaten.
Authenticatievelden
| Veld / Tag | Niveau | Type | Voorbeeldwaarde | Beschrijving |
|---|---|---|---|---|
user_info.auth | Vereist | Integer (1 = success) | 1 | Numerieke verificatiestatus: 1 voor succesvolle authenticatie, 0 voor afwijzing. |
user_info.status | Vereist | String ("Active") | "Active" | Accountstatusbeschrijving, zoals Active, Expired of Banned. |
user_info.exp_date | Vereist | Unix Timestamp / null | "1775000000" | Unix-tijdstempel van het moment waarop het gebruikersabonnement afloopt. |
user_info.max_connections | Vereist | String / Integer | "2" | Maximaal aantal gelijktijdige mediastromen dat is toegestaan voor dit account. |
user_info.allowed_output_formats | Vereist | Array of String | ["m3u8", "ts"] | Lijst met ondersteunde streamingcontainerformaten (m3u8, ts, mp4, mkv). |
server_info | Vereist | Object | {"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"} | Gegevensknooppunt met serverparameters, poortnummers en streamingprotocollen. |
Cataloguseindpunten en acties
| Veld / Tag | Niveau | Type | Voorbeeldwaarde | Beschrijving |
|---|---|---|---|---|
get_live_categories | Vereist | Array of Category Objects | [{"category_id":"1","category_name":"News","parent_id":0}] | API-actie voor het ophalen van alle categorieën voor live televisiezenders. |
get_vod_categories | Vereist | Array of Category Objects | [{"category_id":"10","category_name":"Action","parent_id":0}] | API-actie voor het ophalen van alle categorieën voor video-on-demand films. |
get_series_categories | Vereist | Array of Category Objects | [{"category_id":"20","category_name":"Drama","parent_id":0}] | API-actie voor het ophalen van alle categorieën voor televisieseries. |
get_live_streams | Vereist | Array of Live Stream Objects | [{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}] | API-actie voor het ophalen van kanalen, optioneel gefilterd op categorie-id. |
get_vod_streams | Vereist | Array of VOD Stream Objects | [{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}] | API-actie voor het opvragen van films, optioneel gefilterd per categorie. |
get_series | Vereist | Array of Series Objects | [{"series_id":303,"name":"Example Series","category_id":"20"}] | API-actie voor het opvragen van het overzicht van beschikbare televisieseries. |
get_series_info | Vereist | Series Detail Object (episodes map) | {"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}} | API-actie voor gedetailleerde seriegegevens inclusief seizoenen en afleveringen. |
Gegevensvelden voor Live Stream & VOD
| Veld / Tag | Niveau | Type | Voorbeeldwaarde | Beschrijving |
|---|---|---|---|---|
stream_id | Vereist | Integer / String | 101 | Uniek numeriek identificatienummer van het live-kanaal of de VOD-film. |
name | Vereist | String | "TRT 1 HD" | Weergavenaam van het kanaal of de filmtitel binnen de applicatie. |
stream_type | Vereist | String ("live" | "movie") | "live" | Classificatietype van de stream: 'live' voor televisiezenders of 'movie' voor films. |
stream_icon | Optioneel | URL (http/https) | "https://stream.example.com:8080/images/101.png" | Directe URL naar het kanallogo of de filmomslagafbeelding via HTTPS. |
category_id | Vereist | String / Integer | "1" | Identificatienummer van de categorie waartoe dit media-item behoort. |
container_extension | Vereist | String without dot ("mp4", "mkv", "m3u8") | "mp4" | Bestandsextensie van de mediacontainer zonder voorloopspunt (mp4, mkv, m3u8). |
is_adult | Optioneel | Integer / String ("0" | "1") | "0" | Markering voor inhoud voor volwassenen: 1 indien van toepassing, anders 0. |
Gegevensvelden voor Series & Afleveringen
| Veld / Tag | Niveau | Type | Voorbeeldwaarde | Beschrijving |
|---|---|---|---|---|
series_id | Vereist | Integer / String | 303 | Uniek numeriek identificatienummer van de televisieserie. |
name | Vereist | String | "Example Series" | Canonieke serietitel zoals weergegeven in het serieoverzicht. |
cover | Optioneel | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | Directe afbeeldings-URL van de serieposter of het omslagontwerp. |
category_id | Vereist | String / Integer | "20" | Identificatienummer van de categorie binnen het seriegedeelte. |
season | Vereist | Integer / String | 1 | Seizoensnummer waartoe de specifieke aflevering behoort. |
episode_num | Vereist | Integer / String | 1 | Volgnummer van de aflevering binnen het desbetreffende seizoen. |
container_extension | Vereist | String without dot ("mp4", "mkv") | "mp4" | Bestandsextensie van het afleveringvideobestand zonder voorloopspunt. |
Stream-URL-patronen
| Type | Veld / Tag | Voorbeeldwaarde |
|---|---|---|
| Live TV | {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 |
| Serie-aflevering | {server}/series/{username}/{password}/{episode_id}.{container_extension} | https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4 |
Voorbeeldsjablonen
[
{
"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
}
]
}
}
Interactieve formaatcontrole
Plak hieronder uw M3U-fragment of Xtream JSON-payload om de compatibiliteit met Mayk IP TV te controleren.
Xtream Codes API-compatibiliteitschecklist
- Retourneer user_info.auth = 1 en status = Active voor geldige abonnees.
- Stuur een lege JSON-array [] terug in plaats van null bij lege catalogi.
- Controleer of elk category_id overeenkomt met een geldige categorievermelding.
- Verstrek container_extension zonder voorafgaande punt (bijv. mp4 of mkv).
- Ondersteun HTTP 206 Partial Content-verzoeken voor soepel vooruit- en terugspoelen.