Mayk IP TV

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

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

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

Архитектура на Xtream Codes API

Xtream Codes API осигурява структуриран REST интерфейс, позволяващ на IPTV плейърите да извършват автентикация и да извличат каталози със съдържание.

Автентикация и данни за профила

Клиентът изпраща потребителски данни към player_api.php и получава статус на абонамента, срок на изтичане и параметри на сървъра.

Каталожни действия и категоризация

Специални команди позволяват независимо и ефикасно извличане на канали на живо, VOD филми и многосезонни сериали.

Единна структура на поточните адреси

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' за филми.
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 фрагмент или Xtream JSON отговор по-долу, за да проверите съвместимостта с Mayk IP TV.

Контролен списък за Xtream Codes API

  • Връщайте user_info.auth = 1 и status = Active за валидни абонати.
  • Изпращайте празен JSON масив [] вместо null при празни списъци.
  • Проверявайте дали всяко category_id съответства на реална категория.
  • Посочвайте container_extension без точка в началото (напр. mp4 или mkv).
  • Поддържайте заявки HTTP 206 Partial Content за гладко превъртане на видеото.