Mayk IP TV

Tài liệu kỹ thuật

Quy cách định dạng Xtream Codes IPTV API

Đặc tả kỹ thuật Xtream Codes IPTV API. Điểm cuối xác thực, danh mục, kênh trực tiếp, VOD, phim bộ và kiểm tra tính hợp lệ JSON.

Kiến trúc của Xtream Codes API

Giao diện Xtream Codes API cung cấp giao thức REST có cấu trúc giúp các trình phát IPTV quản lý đăng nhập và truy xuất danh mục nội dung an toàn.

Quy trình xác thực và hồ sơ người dùng

Ứng dụng gửi thông tin đăng nhập đến player_api.php và nhận về trạng thái thuê bao, ngày hết hạn và tham số máy chủ.

Tác vụ danh mục và phân loại

Các lệnh gọi API riêng biệt cho phép tải về độc lập và nhanh chóng danh sách kênh trực tiếp, phim lẻ VOD và các bộ phim nhiều tập.

Cấu trúc đường dẫn luồng chuẩn hóa

Các liên kết luồng tuân theo một quy tắc nhất quán với phần mở rộng vùng chứa tệp phù hợp cho từng loại phương tiện.

Trường xác thực

Trường / ThẻCấp độLoạiGiá trị mẫuMô tả
user_info.authBắt buộcInteger (1 = success)1Trạng thái xác minh dạng số: 1 biểu thị đăng nhập thành công, 0 biểu thị từ chối truy cập.
user_info.statusBắt buộcString ("Active")"Active"Trạng thái tài khoản người dùng hiện tại, ví dụ như Active, Expired hoặc Banned.
user_info.exp_dateBắt buộcUnix Timestamp / null"1775000000"Dấu thời gian Unix xác định ngày giờ hết hạn gói cước của người đăng ký.
user_info.max_connectionsBắt buộcString / Integer"2"Số lượng luồng phát trực tiếp đồng thời tối đa được cho phép đối với tài khoản.
user_info.allowed_output_formatsBắt buộcArray of String["m3u8", "ts"]Danh sách các định dạng vùng chứa luồng được hỗ trợ (m3u8, ts, mp4, mkv).
server_infoBắt buộcObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Đối tượng dữ liệu chứa cổng kết nối của máy chủ, giao thức và cấu hình phát sóng.

Điểm cuối và tác vụ danh mục

Trường / ThẻCấp độLoạiGiá trị mẫuMô tả
get_live_categoriesBắt buộcArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Tác vụ API để truy xuất danh sách thể loại các kênh truyền hình trực tiếp.
get_vod_categoriesBắt buộcArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Tác vụ API để truy xuất danh sách thể loại phim theo yêu cầu (VOD).
get_series_categoriesBắt buộcArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Tác vụ API để truy xuất danh sách thể loại phim bộ nhiều tập.
get_live_streamsBắt buộcArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Tác vụ API liệt kê tất cả các kênh trực tiếp hoặc lọc theo danh mục cụ thể.
get_vod_streamsBắt buộcArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Tác vụ API liệt kê tất cả các phim lẻ VOD hoặc lọc theo danh mục cụ thể.
get_seriesBắt buộcArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Tác vụ API cung cấp danh mục tổng quan về tất cả các bộ phim truyền hình hiện có.
get_series_infoBắt buộcSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Tác vụ API cung cấp thông tin chi tiết về phim bộ bao gồm các mùa và tập phim.

Trường dữ liệu truyền hình trực tiếp và VOD

Trường / ThẻCấp độLoạiGiá trị mẫuMô tả
stream_idBắt buộcInteger / String101Mã định danh số duy nhất của kênh truyền hình trực tiếp hoặc phim lẻ VOD.
nameBắt buộcString"TRT 1 HD"Tên hiển thị của kênh hoặc tiêu đề phim trong giao diện ứng dụng.
stream_typeBắt buộcString ("live" | "movie")"live"Loại luồng phát: 'live' cho kênh truyền hình hoặc 'movie' cho phim lẻ VOD.
stream_iconTùy chọnURL (http/https)"https://stream.example.com:8080/images/101.png"Đường dẫn HTTPS trực tiếp tới biểu trưng kênh hoặc áp phích phim chính thức.
category_idBắt buộcString / Integer"1"Mã định danh thể loại xếp mục truyền thông vào một nhóm danh mục nhất định.
container_extensionBắt buộcString without dot ("mp4", "mkv", "m3u8")"mp4"Phần mở rộng tệp video không có dấu chấm ở đầu (chẳng hạn mp4, mkv, m3u8).
is_adultTùy chọnInteger / String ("0" | "1")"0"Chỉ báo nội dung người lớn: 1 nếu có giới hạn độ tuổi, trường hợp khác là 0.

Trường dữ liệu phim bộ và tập phim

Trường / ThẻCấp độLoạiGiá trị mẫuMô tả
series_idBắt buộcInteger / String303Mã số nhận dạng duy nhất của loạt phim truyền hình trong hệ thống.
nameBắt buộcString"Example Series"Tiêu đề chuẩn của loạt phim truyền hình trong danh mục phát hành.
coverTùy chọnURL (http/https)"https://stream.example.com:8080/images/series303.png"Đường dẫn HTTPS trực tiếp tới hình ảnh áp phích hoặc bìa phim truyền hình.
category_idBắt buộcString / Integer"20"Mã định danh thể loại bên trong danh mục phim bộ truyền hình.
seasonBắt buộcInteger / String1Số thứ tự mùa phát sóng mà tập phim cụ thể này trực thuộc.
episode_numBắt buộcInteger / String1Số thứ tự của tập phim bên trong mùa phát sóng tương ứng.
container_extensionBắt buộcString without dot ("mp4", "mkv")"mp4"Phần mở rộng tệp video của tập phim mà không có dấu chấm ở đầu.

Mẫu đường dẫn luồng phát

LoạiTrường / ThẻGiá trị mẫu
Truyền hình trực tiếp{server}/live/{username}/{password}/{stream_id}.m3u8https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
Phim lẻ (VOD){server}/movie/{username}/{password}/{stream_id}.{container_extension}https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
Tập phim bộ{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Mẫu đoạn mã

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

Công cụ kiểm tra định dạng tương tác

Dán đoạn mã M3U hoặc phản hồi JSON Xtream bên dưới để kiểm tra tính tương thích với Mayk IP TV.

Danh sách kiểm tra Xtream Codes API

  • Trả về user_info.auth = 1 và status = Active đối với các thuê bao còn hạn.
  • Gửi một mảng JSON rỗng [] thay vì giá trị null khi danh mục không có mục nào.
  • Đảm bảo rằng mỗi category_id đều đối chiếu tới một danh mục tồn tại hợp lệ.
  • Cung cấp container_extension không có dấu chấm ở đầu (ví dụ mp4 hoặc mkv).
  • Hỗ trợ các yêu cầu HTTP 206 Partial Content để tua video mượt mà và ổn định.