Mayk IP TV

Rujukan Teknikal

Spesifikasi Format API IPTV Xtream Codes

Spesifikasi teknikal API IPTV Xtream Codes. Titik akhir pengesahan, kategori, strim langsung, VOD, siri dan semakan JSON.

Seni Bina API Xtream Codes

API Xtream Codes menyediakan antara muka REST berstruktur yang membolehkan pemain IPTV mengurus log masuk dan mendapatkan katalog kandungan.

Pengesahan dan Maklumat Pengguna

Aplikasi pelanggan menghantar butiran log masuk ke player_api.php dan menerima status langganan, tarikh tamat serta tetapan pelayan.

Tindakan Katalog dan Pengasingan

Panggilan API khusus membolehkan muat turun saluran langsung, filem VOD dan siri episod secara berasingan dan pantas.

Struktur URL Strim yang Seragam

Pautan strim mematuhi susunan URL yang seragam dengan sambungan format bekas fail yang tepat untuk setiap jenis media.

Medan Pengesahan

Medan / TagTahapJenisNilai ContohPenerangan
user_info.authWajibInteger (1 = success)1Status pengesahan berangka: 1 mengesahkan kejayaan, 0 menandakan capaian ditolak.
user_info.statusWajibString ("Active")"Active"Status akaun pengguna semasa, contohnya Active, Expired atau Banned.
user_info.exp_dateWajibUnix Timestamp / null"1775000000"Cap waktu Unix yang menetapkan tarikh luput langganan akaun pengguna.
user_info.max_connectionsWajibString / Integer"2"Jumlah maksimum sambungan penstriman serentak yang dibenarkan untuk akaun.
user_info.allowed_output_formatsWajibArray of String["m3u8", "ts"]Senarai format bekas strim yang disokong (m3u8, ts, mp4, mkv).
server_infoWajibObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Objek data dengan tetapan pelayan, port sambungan dan protokol siaran.

Titik Akhir dan Tindakan Katalog

Medan / TagTahapJenisNilai ContohPenerangan
get_live_categoriesWajibArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Tindakan API untuk mengambil senarai kategori saluran televisyen langsung.
get_vod_categoriesWajibArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Tindakan API untuk mengambil senarai kategori filem atas permintaan (VOD).
get_series_categoriesWajibArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Tindakan API untuk mengambil senarai kategori siri televisyen.
get_live_streamsWajibArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Tindakan API yang menyenaraikan saluran langsung secara menyeluruh atau mengikut kategori.
get_vod_streamsWajibArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Tindakan API yang menyenaraikan filem VOD secara penuh atau mengikut kategori.
get_seriesWajibArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Tindakan API yang menyediakan gambaran keseluruhan semua siri yang tersedia.
get_series_infoWajibSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Tindakan API untuk butiran siri terperinci termasuk musim dan senarai episod.

Medan Data Siaran Langsung dan VOD

Medan / TagTahapJenisNilai ContohPenerangan
stream_idWajibInteger / String101Pengecam berangka unik bagi saluran langsung atau filem VOD berkenaan.
nameWajibString"TRT 1 HD"Nama saluran atau tajuk filem yang dipaparkan dalam antara muka pengguna.
stream_typeWajibString ("live" | "movie")"live"Jenis strim: 'live' untuk saluran televisyen atau 'movie' untuk filem VOD.
stream_iconPilihanURL (http/https)"https://stream.example.com:8080/images/101.png"Pautan HTTPS terus ke logo saluran atau poster rasmi filem berkenaan.
category_idWajibString / Integer"1"Pengecam kategori yang memautkan item media kepada kumpulan tertentu.
container_extensionWajibString without dot ("mp4", "mkv", "m3u8")"mp4"Sambungan fail video tanpa tanda titik permulaan (seperti mp4, mkv, m3u8).
is_adultPilihanInteger / String ("0" | "1")"0"Penanda kandungan dewasa: 1 jika terdapat sekatan umur penonton, selainnya 0.

Medan Data Siri dan Episod

Medan / TagTahapJenisNilai ContohPenerangan
series_idWajibInteger / String303Nombor pengenalan berangka unik bagi siri televisyen yang berkaitan.
nameWajibString"Example Series"Tajuk rasmi siri televisyen dalam katalog perpustakaan rancangan.
coverPilihanURL (http/https)"https://stream.example.com:8080/images/series303.png"Pautan HTTPS terus ke imej poster atau kulit siri televisyen.
category_idWajibString / Integer"20"Pengecam kategori penempatan dalam senarai siri televisyen.
seasonWajibInteger / String1Nombor musim tayangan di mana episod khusus ini terkandung.
episode_numWajibInteger / String1Nombor giliran episod di dalam musim televisyen yang berkaitan.
container_extensionWajibString without dot ("mp4", "mkv")"mp4"Sambungan fail video episod berkenaan tanpa tanda titik.

Corak URL Strim

JenisMedan / TagNilai Contoh
TV Langsung{server}/live/{username}/{password}/{stream_id}.m3u8https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
Filem (VOD){server}/movie/{username}/{password}/{stream_id}.{container_extension}https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
Episod Siri{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Contoh Templat

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

Pemeriksa Format Interaktif

Tampal keratan M3U atau muatan JSON Xtream di bawah untuk mengesahkan keserasian dengan Mayk IP TV.

Senarai Semak API Xtream Codes

  • Kembalikan user_info.auth = 1 dan status = Active untuk pelanggan yang sah.
  • Hantarkan tatasusunan JSON kosong [] dan bukannya null bagi senarai kosong.
  • Pastikan setiap category_id merujuk kepada kategori yang benar-benar wujud.
  • Nyatakan container_extension tanpa tanda titik di hadapan (cth. mp4 atau mkv).
  • Sokong permintaan HTTP 206 Partial Content untuk kelancaran mandu laju video.