Mayk IP TV

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 / EtiquetaNivellTipusValor d'exempleDescripció
user_info.authObligatoriInteger (1 = success)1Codi d'estat d'autenticació: 1 indica credencials correctes.
user_info.statusObligatoriString ("Active")"Active"Estat del compte; ha de ser 'Active' per permetre la reproducció.
user_info.exp_dateObligatoriUnix Timestamp / null"1775000000"Data de venciment en marca horària Unix, o null per a accés il·limitat.
user_info.max_connectionsObligatoriString / Integer"2"Nombre màxim de connexions actives simultànies permeses.
user_info.allowed_output_formatsObligatoriArray of String["m3u8", "ts"]Formats de vídeo compatibles amb el servidor (m3u8, ts, mp4, mkv).
server_infoObligatoriObject{"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 / EtiquetaNivellTipusValor d'exempleDescripció
get_live_categoriesObligatoriArray 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_categoriesObligatoriArray 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_categoriesObligatoriArray 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_streamsObligatoriArray 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_streamsObligatoriArray 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_seriesObligatoriArray 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_infoObligatoriSeries 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 / EtiquetaNivellTipusValor d'exempleDescripció
stream_idObligatoriInteger / String101Identificador numèric o de text únic per a emissions i pel·lícules.
nameObligatoriString"TRT 1 HD"Títol visible del canal de televisió o de la pel·lícula.
stream_typeObligatoriString ("live" | "movie")"live"Tipus d'emissió: 'live' per a canals en directe, 'movie' per a pel·lícules.
stream_iconOpcionalURL (http/https)"https://stream.example.com:8080/images/101.png"URL directa en HTTP o HTTPS cap al logotip del canal o cartell.
category_idObligatoriString / Integer"1"Identificador de categoria que fa referència a una categoria vàlida.
container_extensionObligatoriString without dot ("mp4", "mkv", "m3u8")"mp4"Extensió del fitxer de vídeo sense punt inicial (mp4, mkv, m3u8).
is_adultOpcionalInteger / String ("0" | "1")"0"Indicador de contingut per a adults: '1' senyala material restringit.

Camps de sèries i episodis

Camp / EtiquetaNivellTipusValor d'exempleDescripció
series_idObligatoriInteger / String303Identificador únic del registre de la sèrie de televisió.
nameObligatoriString"Example Series"Títol canònic de la sèrie de televisió.
coverOpcionalURL (http/https)"https://stream.example.com:8080/images/series303.png"URL directa en HTTP o HTTPS cap al cartell de la sèrie.
category_idObligatoriString / Integer"20"Identificador de categoria present a la llista de categories de sèries.
seasonObligatoriInteger / String1Número de temporada que conté l'episodi corresponent.
episode_numObligatoriInteger / String1Número d'ordre de l'episodi dins de la temporada.
container_extensionObligatoriString without dot ("mp4", "mkv")"mp4"Extensió de fitxer de vídeo sense punt inicial per a l'episodi.

Patrons d'URL d'emissió

TipusCamp / EtiquetaValor d'exemple
TV en directe{server}/live/{username}/{password}/{stream_id}.m3u8https://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

GET /player_api.php (user_info & server_info)
{
  "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"
  }
}
get_live_streams & get_vod_streams
[
  {
    "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"
  }
]
get_series_info (seasons & episodes)
{
  "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.