{
"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"
}
}
Техническа документация
Спецификация на формата на 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 / String | 101 | Уникален цифров номер на канала на живо или филма по заявка. |
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 / String | 303 | Уникален цифров идентификатор на телевизионния сериал. |
name | Задължително | String | "Example Series" | Канонично заглавие на телевизионния сериал в каталога. |
cover | По избор | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | Директен HTTPS уеб адрес към заглавния плакат на сериала. |
category_id | Задължително | String / Integer | "20" | Идентификатор на категория в списъка със сериали. |
season | Задължително | Integer / String | 1 | Номер на сезона, към който се отнася съответният епизод. |
episode_num | Задължително | Integer / String | 1 | Пореден номер на епизода в рамките на съответния сезон. |
container_extension | Задължително | String without dot ("mp4", "mkv") | "mp4" | Файлово разширение на видеоклипа на епизода без точка. |
Модели на URL адреси за потоци
| Тип | Поле / Таг | Примерна стойност |
|---|---|---|
| Телевизия на живо | {server}/live/{username}/{password}/{stream_id}.m3u8 | https://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 |
Примерни шаблони
[
{
"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"
}
]
{
"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 за гладко превъртане на видеото.