{
"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"
}
}
Referència d'API tècnica
Estàndards Xtream Codes player_api.php
Consulteu els esquemes de dades, el protocol d'autenticació i les respostes de catàleg que requereix Mayk IP TV amb Xtream.
Autenticació i dades del servidor
El punt GET /player_api.php retorna els objectes user_info i server_info en format JSON. L'accés correcte requereix user_info.auth igual a 1 i estat 'Active'.
Sis accions fonamentals de catàleg
Mayk IP TV consulta categories mitjançant get_live_categories, get_vod_categories i get_series_categories, i continguts amb get_live_streams, get_vod_streams i get_series. Llistes buides han de retornar [].
Integritat de categories i elements orfes
Cada emissió ha d'apuntar a un category_id existent a la resposta de categories. Els identificadors orfes provoquen que el contingut no es mostri.
Metadades de sèries i desglossament d'episodis
Els detalls de la sèrie s'obtenen amb get_series_info&series_id=.... La resposta ha d'incloure un objecte episodes indexat pel número de temporada.
URL de reproducció i compatibilitat amb intervals de bytes
Les emissions s'articulen seguint els patrons /live/, /movie/ i /series/. Els servidors de VOD i sèries han de suportar HTTP 206 Partial Content per al control de l'avanç.
Camps d'autenticació
| Camp / Etiqueta | Nivell | Tipus | Valor d'exemple | Descripció |
|---|---|---|---|---|
user_info.auth | Obligatori | Integer (1 = success) | 1 | Codi d'estat d'autenticació: 1 indica credencials correctes. |
user_info.status | Obligatori | String ("Active") | "Active" | Estat del compte; ha de ser 'Active' per permetre la reproducció. |
user_info.exp_date | Obligatori | Unix Timestamp / null | "1775000000" | Data de venciment en marca horària Unix, o null per a accés il·limitat. |
user_info.max_connections | Obligatori | String / Integer | "2" | Nombre màxim de connexions actives simultànies permeses. |
user_info.allowed_output_formats | Obligatori | Array of String | ["m3u8", "ts"] | Formats de vídeo compatibles amb el servidor (m3u8, ts, mp4, mkv). |
server_info | Obligatori | Object | {"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"} | Objecte amb paràmetres del servidor, ports de connexió i protocol. |
Accions i punts de catàleg
| Camp / Etiqueta | Nivell | Tipus | Valor d'exemple | Descripció |
|---|---|---|---|---|
get_live_categories | Obligatori | Array of Category Objects | [{"category_id":"1","category_name":"News","parent_id":0}] | Acció que retorna la llista de categories de televisió en directe. |
get_vod_categories | Obligatori | Array of Category Objects | [{"category_id":"10","category_name":"Action","parent_id":0}] | Acció que retorna la llista de categories de pel·lícules a la carta. |
get_series_categories | Obligatori | Array of Category Objects | [{"category_id":"20","category_name":"Drama","parent_id":0}] | Acció que retorna la llista de categories de sèries de televisió. |
get_live_streams | Obligatori | Array of Live Stream Objects | [{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}] | Acció que retorna tots els canals en directe o filtrats per categoria. |
get_vod_streams | Obligatori | Array of VOD Stream Objects | [{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}] | Acció que retorna totes les pel·lícules o filtrades per categoria. |
get_series | Obligatori | Array of Series Objects | [{"series_id":303,"name":"Example Series","category_id":"20"}] | Acció que retorna la vista general de les sèries de televisió. |
get_series_info | Obligatori | Series Detail Object (episodes map) | {"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}} | Acció detallada que proporciona temporades i el mapa d'episodis. |
Camps d'emissió en directe i VOD
| Camp / Etiqueta | Nivell | Tipus | Valor d'exemple | Descripció |
|---|---|---|---|---|
stream_id | Obligatori | Integer / String | 101 | Identificador numèric o de text únic per a emissions i pel·lícules. |
name | Obligatori | String | "TRT 1 HD" | Títol visible del canal de televisió o de la pel·lícula. |
stream_type | Obligatori | String ("live" | "movie") | "live" | Tipus d'emissió: 'live' per a canals en directe, 'movie' per a pel·lícules. |
stream_icon | Opcional | URL (http/https) | "https://stream.example.com:8080/images/101.png" | URL directa en HTTP o HTTPS cap al logotip del canal o cartell. |
category_id | Obligatori | String / Integer | "1" | Identificador de categoria que fa referència a una categoria vàlida. |
container_extension | Obligatori | String without dot ("mp4", "mkv", "m3u8") | "mp4" | Extensió del fitxer de vídeo sense punt inicial (mp4, mkv, m3u8). |
is_adult | Opcional | Integer / String ("0" | "1") | "0" | Indicador de contingut per a adults: '1' senyala material restringit. |
Camps de sèries i episodis
| Camp / Etiqueta | Nivell | Tipus | Valor d'exemple | Descripció |
|---|---|---|---|---|
series_id | Obligatori | Integer / String | 303 | Identificador únic del registre de la sèrie de televisió. |
name | Obligatori | String | "Example Series" | Títol canònic de la sèrie de televisió. |
cover | Opcional | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | URL directa en HTTP o HTTPS cap al cartell de la sèrie. |
category_id | Obligatori | String / Integer | "20" | Identificador de categoria present a la llista de categories de sèries. |
season | Obligatori | Integer / String | 1 | Número de temporada que conté l'episodi corresponent. |
episode_num | Obligatori | Integer / String | 1 | Número d'ordre de l'episodi dins de la temporada. |
container_extension | Obligatori | String without dot ("mp4", "mkv") | "mp4" | Extensió de fitxer de vídeo sense punt inicial per a l'episodi. |
Patrons d'URL d'emissió
| Tipus | Camp / Etiqueta | Valor d'exemple |
|---|---|---|
| TV en directe | {server}/live/{username}/{password}/{stream_id}.m3u8 | https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8 |
| Pel·lícula (VOD) | {server}/movie/{username}/{password}/{stream_id}.{container_extension} | https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4 |
| Episodi de sèrie | {server}/series/{username}/{password}/{episode_id}.{container_extension} | https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4 |
Plantilles 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
}
]
}
}
Comprovador de format interactiu
Enganxeu el vostre fragment M3U o resposta JSON Xtream a continuació per comprovar la compatibilitat amb Mayk IP TV.
Llista de control de compatibilitat Xtream
- Retorneu user_info.auth = 1 i status = Active amb credencials correctes.
- Retorneu una matriu JSON buida [] en lloc de null per a llistes buides.
- Comproveu que cada category_id correspongui a una categoria registrada.
- Envieu container_extension sense punt inicial (per exemple, mp4 o mkv).
- Suporteu peticions de rang HTTP 206 Partial Content per al desplaçament temporal.