Mayk IP TV

Технічна документація

Специфікація формату Xtream Codes IPTV API

Технічна специфікація Xtream Codes IPTV API. Кінцеві точки для автентифікації, категорій, прямого ефіру, VOD, серіалів та перевірки JSON.

Архітектура протоколу Xtream Codes API

Xtream Codes API надає впорядкований REST-інтерфейс, за допомогою якого IPTV-клієнти здійснюють авторизацію та отримують каталоги медіа.

Авторизація та відомості про профіль

Клієнтський додаток надсилає дані входу до player_api.php та одержує статус передплати, термін дії та налаштування сервера.

Каталожні команди та категорії

Окремі виклики API дають змогу ефективно та незалежно завантажувати прямі канали, фільми на замовлення та серіали.

Уніфікований формат потокових посилань

URL-адреси потоків будуються за чіткою структурою з відповідним форматом контейнера для кожного медіафайлу.

Поля автентифікації

Поле / ТегРівеньТипПриклад значенняОпис
user_info.authОбов'язковоInteger (1 = success)1Цифровий статус перевірки: 1 підтверджує успішний вхід, 0 означає відмову.
user_info.statusОбов'язковоString ("Active")"Active"Поточний статус облікового запису, наприклад Active, Expired або Banned.
user_info.exp_dateОбов'язковоUnix Timestamp / null"1775000000"Позначка часу Unix, що вказує дату завершення передплати користувача.
user_info.max_connectionsОбов'язковоString / Integer"2"Максимально дозволена кількість одночасних потоків для облікового запису.
user_info.allowed_output_formatsОбов'язковоArray of String["m3u8", "ts"]Список підтримуваних форматів медіаконтейнерів потоку (m3u8, ts, mp4, mkv).
server_infoОбов'язковоObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Об'єкт даних з параметрами сервера, мережевими портами та протоколами.

Кінцеві точки та дії каталогу

Поле / ТегРівеньТипПриклад значенняОпис
get_live_categoriesОбов'язковоArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Дія API для отримання списку категорій телеканалів прямого ефіру.
get_vod_categoriesОбов'язковоArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Дія API для отримання категорій фільмів на замовлення (VOD).
get_series_categoriesОбов'язковоArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Дія API для отримання категорій телевізійних серіалів.
get_live_streamsОбов'язковоArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Дія API, яка повертає канали прямого ефіру загалом або за категорією.
get_vod_streamsОбов'язковоArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Дія API, яка повертає фільми VOD загалом або за вибраною категорією.
get_seriesОбов'язковоArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Дія API, що надає загальний список усіх доступних телесеріалів.
get_series_infoОбов'язковоSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Дія API для докладних відомостей про серіал, включно із сезонами та серіями.

Поля даних прямого ефіру та VOD

Поле / ТегРівеньТипПриклад значенняОпис
stream_idОбов'язковоInteger / String101Унікальний цифровий ідентифікатор телеканалу або фільму на замовлення.
nameОбов'язковоString"TRT 1 HD"Відображувана назва каналу чи фільму в інтерфейсі користувача.
stream_typeОбов'язковоString ("live" | "movie")"live"Тип потоку: 'live' для телевізійних каналів або 'movie' для фільмів VOD.
stream_iconНеобов'язковоURL (http/https)"https://stream.example.com:8080/images/101.png"Пряма адреса HTTPS до логотипа каналу або офіційного постера фільму.
category_idОбов'язковоString / Integer"1"Ідентифікатор категорії, що закріплює елемент за певною групою.
container_extensionОбов'язковоString without dot ("mp4", "mkv", "m3u8")"mp4"Розширення відеофайлу без початкової крапки (наприклад, mp4, mkv, m3u8).
is_adultНеобов'язковоInteger / String ("0" | "1")"0"Позначка вмісту для дорослих: 1 за наявності вікових обмежень, інакше 0.

Поля даних серіалів та серій

Поле / ТегРівеньТипПриклад значенняОпис
series_idОбов'язковоInteger / String303Унікальний цифровий ідентифікатор телевізійного серіалу.
nameОбов'язковоString"Example Series"Офіційна назва телесеріалу в каталозі мультимедійного вмісту.
coverНеобов'язковоURL (http/https)"https://stream.example.com:8080/images/series303.png"Пряма адреса HTTPS до титульного постера або обкладинки серіалу.
category_idОбов'язковоString / Integer"20"Ідентифікатор категорії в переліку телевізійних серіалів.
seasonОбов'язковоInteger / String1Номер сезону, до якого належить відповідна серія проєкту.
episode_numОбов'язковоInteger / String1Порядковий номер серії в межах відповідного сезону.
container_extensionОбов'язковоString without dot ("mp4", "mkv")"mp4"Розширення відеофайлу серії без початкової крапки.

Шаблони URL-адрес потоків

ТипПоле / ТегПриклад значення
Прямий ефір{server}/live/{username}/{password}/{stream_id}.m3u8https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
Фільм (VOD){server}/movie/{username}/{password}/{stream_id}.{container_extension}https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
Серія серіалу{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Зразки шаблонів

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

Інтерактивна перевірка формату

Вставте фрагмент M3U або JSON-відповідь Xtream нижче для перевірки сумісності з Mayk IP TV.

Контрольний список для Xtream Codes API

  • Повертайте user_info.auth = 1 та status = Active для дійсних передплатників.
  • Надсилайте порожній JSON-масив [] замість null у разі відсутності записів.
  • Переконайтеся, що кожен category_id вказує на наявну категорію.
  • Вказуйте container_extension без крапки на початку (наприклад, mp4 або mkv).
  • Підтримуйте запити HTTP 206 Partial Content для плавного перемотування відео.