Mayk IP TV

Referência de API técnica

Normas Xtream Codes player_api.php em Portugal

Conheça os esquemas de dados, o fluxo de autenticação e as respostas de catálogo pretendidas pelo Mayk IP TV via Xtream Codes.

Autenticação e dados do servidor

O pedido GET /player_api.php faculta os blocos JSON user_info e server_info. O início de sessão exige user_info.auth igual a 1 e o estado como 'Active'.

Seis ações vitais de catálogo

O Mayk IP TV pesquisa categorias com get_live_categories, get_vod_categories e get_series_categories, e emissões com get_live_streams, get_vod_streams e get_series. Listas sem dados têm de render [].

Integridade das categorias e entradas órfãs

Cada transmissão tem de apontar para um category_id existente na lista de categorias. Identificadores não coincidentes causam a omissão dos canais.

Metadados de séries e grelha de episódios

Os pormenores da série são obtidos através de get_series_info&series_id=.... A resposta deve conter o objeto episodes indexado pelo número de temporada.

Endereços de leitura e suporte a pedidos de intervalo

As transmissões seguem os caminhos /live/, /movie/ e /series/. Servidores de VOD e séries têm de aceitar HTTP 206 Partial Content para permitir o avanço temporal.

Campos de autenticação

Campo / EtiquetaNívelTipoValor de exemploDescrição
user_info.authObrigatórioInteger (1 = success)1Código de estado de autenticação: 1 confirma credenciais válidas.
user_info.statusObrigatórioString ("Active")"Active"Estado da subscrição; tem de estar 'Active' para autorizar a reprodução.
user_info.exp_dateObrigatórioUnix Timestamp / null"1775000000"Data de expiração em timestamp Unix, ou null para acesso ilimitado.
user_info.max_connectionsObrigatórioString / Integer"2"Número máximo admitido de ligações ativas em simultâneo.
user_info.allowed_output_formatsObrigatórioArray of String["m3u8", "ts"]Formatos de vídeo aceites pelo servidor (m3u8, ts, mp4, mkv).
server_infoObrigatórioObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Objeto com detalhes do servidor, portas de ligação e protocolo.

Ações e pontos de catálogo

Campo / EtiquetaNívelTipoValor de exemploDescrição
get_live_categoriesObrigatórioArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Ação que lista as categorias de televisão em direto.
get_vod_categoriesObrigatórioArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Ação que lista as categorias de filmes a pedido.
get_series_categoriesObrigatórioArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Ação que lista as categorias de séries de televisão.
get_live_streamsObrigatórioArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Ação que lista todos os canais em direto ou filtrados por categoria.
get_vod_streamsObrigatórioArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Ação que lista todos os filmes ou filtrados por categoria.
get_seriesObrigatórioArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Ação que faculta o catálogo geral de séries de televisão.
get_series_infoObrigatórioSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Ação detalhada com temporadas e o mapeamento de episódios.

Campos de emissão em direto e VOD

Campo / EtiquetaNívelTipoValor de exemploDescrição
stream_idObrigatórioInteger / String101Identificador numérico ou alfanumérico único para emissões e filmes.
nameObrigatórioString"TRT 1 HD"Nome visível do canal de televisão ou do filme a pedido.
stream_typeObrigatórioString ("live" | "movie")"live"Classificação da emissão: 'live' para canais, 'movie' para filmes.
stream_iconOpcionalURL (http/https)"https://stream.example.com:8080/images/101.png"URL direto HTTP ou HTTPS para o logótipo do canal ou cartaz do filme.
category_idObrigatórioString / Integer"1"Identificador de categoria referente a uma categoria válida.
container_extensionObrigatórioString without dot ("mp4", "mkv", "m3u8")"mp4"Extensão do formato de ficheiro sem ponto inicial (mp4, mkv, m3u8).
is_adultOpcionalInteger / String ("0" | "1")"0"Indicador de conteúdo para adultos: '1' assinala material reservado.

Campos de séries e episódios

Campo / EtiquetaNívelTipoValor de exemploDescrição
series_idObrigatórioInteger / String303Identificador único da série de televisão.
nameObrigatórioString"Example Series"Título canónico da série de televisão.
coverOpcionalURL (http/https)"https://stream.example.com:8080/images/series303.png"URL direto HTTP ou HTTPS para a imagem de capa da série.
category_idObrigatórioString / Integer"20"Identificador de categoria existente nas categorias de séries.
seasonObrigatórioInteger / String1Número da temporada a que o episódio específico diz respeito.
episode_numObrigatórioInteger / String1Número de sequência do episódio na respetiva temporada.
container_extensionObrigatórioString without dot ("mp4", "mkv")"mp4"Extensão do ficheiro de vídeo sem ponto inicial para o episódio.

Padrões de URL de emissão

TipoCampo / EtiquetaValor de exemplo
TV em direto{server}/live/{username}/{password}/{stream_id}.m3u8https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
Filme (VOD){server}/movie/{username}/{password}/{stream_id}.{container_extension}https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
Episódio de série{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Modelos de exemplo

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

Verificador de formato interativo

Cole o seu excerto M3U ou resposta JSON Xtream abaixo para verificar a conformidade com o Mayk IP TV.

Lista de verificação de compatibilidade Xtream

  • Devolva user_info.auth = 1 e status = Active para acessos válidos.
  • Devolva uma matriz JSON vazia [] em vez de null caso a lista esteja vazia.
  • Certifique-se de que cada category_id coincide com uma categoria válida.
  • Envie container_extension sem ponto no início (por exemplo, mp4 ou mkv).
  • Garanta o suporte a pedidos HTTP 206 Partial Content para a navegação nos vídeos.