Mayk IP TV

技术文档

Xtream Codes IPTV API 格式规范

Xtream Codes IPTV API 接口技术规范指南。全面涵盖鉴权认证、分类体系、直播频道、VOD 电影与剧集端点,并提供交互式 JSON 验证工具。

Xtream Codes API 架构设计

Xtream Codes API 提供了规范的 RESTful 接口体系,使 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}]用于获取点播电影 (VOD) 分类列表的 API 请求操作。
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 操作。
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 操作。

直播与点播数据字段

字段 / 标签层级类型示例值说明
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 与 Active 状态。
  • 若返回的分类或内容目录为空,请返回空数组 [] 而非 null 值。
  • 核实每一个 category_id 均能映射至真实存在的有效类别定义中。
  • 在 container_extension 字段中请勿添加前导句点(例如填写 mp4 而非 .mp4)。
  • 全面支持 HTTP 206 Partial Content 协议以确保播放进度快速随意拖动。