Mayk IP TV

Référence API technique

Normes Xtream Codes player_api.php

Consultez les schémas de données, le protocole d'authentification et les réponses de catalogue attendus par Mayk IP TV.

Authentification et informations serveur

L'appel GET /player_api.php renvoie les objets user_info et server_info. L'authentification réussie exige user_info.auth égal à 1 et un statut fixé à 'Active'.

Six actions de catalogue fondamentales

Mayk IP TV interroge get_live_categories, get_vod_categories, get_series_categories, ainsi que get_live_streams, get_vod_streams et get_series. Les listes vides doivent retourner [].

Intégrité des catégories et éléments orphelins

Chaque flux et série doit pointer vers un category_id existant dans la réponse des catégories. Les identifiants inexistants entraînent la disparition d'éléments.

Métadonnées de série et cartographie des épisodes

Les détails sont obtenus via get_series_info&series_id=.... La réponse doit comporter un dictionnaire episodes indexé par numéro de saison.

URL de lecture et prise en charge des plages d'octets

Les flux utilisent les modèles /live/, /movie/ et /series/. Les serveurs VOD et séries doivent supporter HTTP 206 Partial Content pour l'avance rapide.

Champs d'authentification

Champ / BaliseNiveauTypeExempleDescription
user_info.authRequisInteger (1 = success)1Code d'état d'authentification : 1 indique des identifiants valides.
user_info.statusRequisString ("Active")"Active"État du compte d'abonnement ; doit être 'Active' pour la lecture.
user_info.exp_dateRequisUnix Timestamp / null"1775000000"Date d'expiration en secondes Unix, ou null pour un accès illimité.
user_info.max_connectionsRequisString / Integer"2"Nombre maximal de connexions simultanées autorisées.
user_info.allowed_output_formatsRequisArray of String["m3u8", "ts"]Formats de conteneur supportés par le serveur (m3u8, ts, mp4, mkv).
server_infoRequisObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Objet contenant les paramètres du serveur, ports et protocole.

Actions et points de terminaison

Champ / BaliseNiveauTypeExempleDescription
get_live_categoriesRequisArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Action retournant la liste des catégories de télévision en direct.
get_vod_categoriesRequisArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Action retournant la liste des catégories de films à la demande.
get_series_categoriesRequisArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Action retournant la liste des catégories de séries télévisées.
get_live_streamsRequisArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Action retournant toutes les chaînes en direct ou filtrées par catégorie.
get_vod_streamsRequisArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Action retournant tous les films à la demande ou filtrés par catégorie.
get_seriesRequisArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Action retournant l'aperçu général des séries télévisées.
get_series_infoRequisSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Action détaillée retournant les saisons et la liste des épisodes.

Champs de données Live et VOD

Champ / BaliseNiveauTypeExempleDescription
stream_idRequisInteger / String101Identifiant unique numérique ou chaîne pour les flux en direct et films.
nameRequisString"TRT 1 HD"Titre d'affichage de la chaîne ou du film à la demande.
stream_typeRequisString ("live" | "movie")"live"Type de flux : 'live' pour la TV en direct, 'movie' pour la VOD.
stream_iconOptionnelURL (http/https)"https://stream.example.com:8080/images/101.png"URL directe HTTP/HTTPS vers le logo de la chaîne ou l'affiche du film.
category_idRequisString / Integer"1"Identifiant de catégorie correspondant à une catégorie valide.
container_extensionRequisString without dot ("mp4", "mkv", "m3u8")"mp4"Extension de conteneur cible sans point initial (mp4, mkv, m3u8).
is_adultOptionnelInteger / String ("0" | "1")"0"Indicateur de contenu adulte : '1' signale du matériel pour adultes.

Champs de séries et épisodes

Champ / BaliseNiveauTypeExempleDescription
series_idRequisInteger / String303Identifiant unique de la fiche de série télévisée.
nameRequisString"Example Series"Titre canonique de la série télévisée.
coverOptionnelURL (http/https)"https://stream.example.com:8080/images/series303.png"URL directe HTTP/HTTPS de l'affiche de la série.
category_idRequisString / Integer"20"Identifiant de catégorie existant dans les catégories de séries.
seasonRequisInteger / String1Numéro de saison contenant l'épisode concerné.
episode_numRequisInteger / String1Numéro d'ordre de l'épisode dans la saison.
container_extensionRequisString without dot ("mp4", "mkv")"mp4"Extension de fichier vidéo sans point initial pour l'épisode.

Modèles d'URL de flux

TypeChamp / BaliseExemple
TV en direct{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
Épisode de série{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Modèles 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
      }
    ]
  }
}

Vérificateur de format interactif

Collez votre extrait M3U ou réponse JSON Xtream ci-dessous pour vérifier sa conformité avec Mayk IP TV.

Liste de contrôle de compatibilité Xtream

  • Renvoyez user_info.auth = 1 et status = Active lorsque les accès sont bons.
  • Renvoyez un tableau JSON vide [] plutôt que null pour les listes vides.
  • Vérifiez que chaque category_id correspond à une catégorie existante.
  • Transmettez container_extension sans point initial (ex. mp4, mkv).
  • Assurez le support de HTTP 206 Partial Content pour la navigation vidéo.