Mayk IP TV

Riferimento API tecnico

Standard Xtream Codes player_api.php

Esamina gli schemi dati, il flusso di autenticazione e le risposte dei cataloghi attesi da Mayk IP TV tramite API Xtream Codes.

Autenticazione e informazioni server

L'endpoint GET /player_api.php restituisce gli oggetti JSON user_info e server_info. L'accesso richiede user_info.auth impostato a 1 e lo stato dell'account su 'Active'.

Sei azioni fondamentali del catalogo

Mayk IP TV richiede categorie tramite get_live_categories, get_vod_categories e get_series_categories, e i contenuti con get_live_streams, get_vod_streams e get_series. Liste vuote devono rendere [].

Integrità delle categorie ed elementi orfani

Ogni flusso deve fare riferimento a un category_id valido presente nella lista categorie. Gli identificativi non corrispondenti rendono i canali invisibili.

Metadati delle serie e mappa episodi

I dettagli completi si ottengono tramite get_series_info&series_id=.... La risposta deve contenere un oggetto episodes indicizzato per numero di stagione.

URL di riproduzione e supporto Range HTTP

I flussi sono costruiti secondo i percorsi standard /live/, /movie/ e /series/. I server VOD e serie devono supportare HTTP 206 Partial Content per il riavvolgimento e l'avanzamento.

Campi di autenticazione

Campo / TagLivelloTipoValore di esempioDescrizione
user_info.authObbligatorioInteger (1 = success)1Codice di stato autenticazione: il valore 1 indica credenziali corrette.
user_info.statusObbligatorioString ("Active")"Active"Stato dell'abbonamento; deve essere 'Active' per consentire lo streaming.
user_info.exp_dateObbligatorioUnix Timestamp / null"1775000000"Data di scadenza in formato timestamp Unix, oppure null per accesso senza limiti.
user_info.max_connectionsObbligatorioString / Integer"2"Numero massimo di connessioni attive simultanee permesse.
user_info.allowed_output_formatsObbligatorioArray of String["m3u8", "ts"]Formati video supportati dal server (m3u8, ts, mp4, mkv).
server_infoObbligatorioObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Oggetto contenente impostazioni server, porte e protocollo.

Azioni ed endpoint catalogo

Campo / TagLivelloTipoValore di esempioDescrizione
get_live_categoriesObbligatorioArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Azione che restituisce l'elenco delle categorie della TV in diretta.
get_vod_categoriesObbligatorioArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Azione che restituisce l'elenco delle categorie di film on demand.
get_series_categoriesObbligatorioArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Azione che restituisce l'elenco delle categorie di serie televisive.
get_live_streamsObbligatorioArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Azione che restituisce i canali in diretta oppure filtrati per categoria.
get_vod_streamsObbligatorioArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Azione che restituisce tutti i film oppure filtrati per categoria.
get_seriesObbligatorioArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Azione che restituisce l'elenco delle serie televisive disponibili.
get_series_infoObbligatorioSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Azione che restituisce i dettagli della serie e l'elenco degli episodi.

Campi dati Live e VOD

Campo / TagLivelloTipoValore di esempioDescrizione
stream_idObbligatorioInteger / String101Identificativo numerico o alfanumerico univoco per canali e film.
nameObbligatorioString"TRT 1 HD"Nome visibile del canale televisivo o del film.
stream_typeObbligatorioString ("live" | "movie")"live"Tipo di flusso: 'live' per canali in diretta, 'movie' per film on demand.
stream_iconOpzionaleURL (http/https)"https://stream.example.com:8080/images/101.png"URL diretto HTTP o HTTPS all'immagine del logo del canale o locandina.
category_idObbligatorioString / Integer"1"Identificativo di categoria che rimanda a una categoria esistente.
container_extensionObbligatorioString without dot ("mp4", "mkv", "m3u8")"mp4"Estensione del file video senza punto iniziale (mp4, mkv, m3u8).
is_adultOpzionaleInteger / String ("0" | "1")"0"Segnalatore contenuti per adulti: '1' contrassegna materiale protetto.

Campi dati serie ed episodi

Campo / TagLivelloTipoValore di esempioDescrizione
series_idObbligatorioInteger / String303Identificativo univoco della serie televisiva.
nameObbligatorioString"Example Series"Titolo standard della serie televisiva.
coverOpzionaleURL (http/https)"https://stream.example.com:8080/images/series303.png"URL diretto HTTP o HTTPS alla locandina della serie.
category_idObbligatorioString / Integer"20"Identificativo di categoria presente nell'elenco delle categorie serie.
seasonObbligatorioInteger / String1Numero di stagione a cui appartiene l'episodio specifico.
episode_numObbligatorioInteger / String1Numero d'ordine dell'episodio all'interno della stagione.
container_extensionObbligatorioString without dot ("mp4", "mkv")"mp4"Estensione del file video senza punto iniziale per l'episodio.

Modelli URL di riproduzione

TipoCampo / TagValore di esempio
TV in diretta{server}/live/{username}/{password}/{stream_id}.m3u8https://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
Episodio serie{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Modelli di esempio

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
      }
    ]
  }
}

Verificatore di formato interattivo

Incolla il testo M3U o la risposta JSON Xtream qui sotto per verificare la compatibilità con Mayk IP TV.

Elenco di controllo compatibilità Xtream

  • Restituisci user_info.auth = 1 e status = Active per accessi validi.
  • Restituisci un array JSON vuoto [] invece di null in assenza di dati.
  • Controlla che ogni category_id corrisponda a una categoria reale.
  • Invia container_extension senza punto iniziale (es. mp4, mkv).
  • Supporta richieste HTTP 206 Partial Content per consentire la ricerca temporale.