Mayk IP TV

Referensi Teknis

Spesifikasi Format API IPTV Xtream Codes

Spesifikasi teknis API IPTV Xtream Codes. Titik akhir autentikasi, kategori, saluran langsung, VOD, serial TV, dan validasi JSON.

Arsitektur API Xtream Codes

API Xtream Codes menyediakan antarmuka REST terstruktur yang memungkinkan aplikasi IPTV menangani login dan mengunduh katalog konten secara aman.

Autentikasi dan Profil Pengguna

Aplikasi mengirimkan kredensial ke player_api.php dan menerima status langganan, tanggal kedaluwarsa, serta konfigurasi server.

Tindakan Katalog dan Pembagian Kategori

Perintah API terpisah memungkinkan pengunduhan saluran langsung, film VOD, dan serial episode secara cepat dan independen.

Struktur URL Aliran yang Seragam

Tautan aliran mengikuti pola URL yang teratur dengan ekstensi wadah berkas yang tepat untuk setiap jenis media.

Bidang Autentikasi

Bidang / TagTingkatTipeNilai ContohDeskripsi
user_info.authWajibInteger (1 = success)1Status verifikasi numerik: 1 menandakan berhasil, 0 menandakan akses ditolak.
user_info.statusWajibString ("Active")"Active"Status akun pengguna saat ini, misalnya Active, Expired, atau Banned.
user_info.exp_dateWajibUnix Timestamp / null"1775000000"Stempel waktu Unix yang menunjukkan batas akhir masa berlaku langganan akun.
user_info.max_connectionsWajibString / Integer"2"Jumlah batas sambungan streaming simultan maksimum yang diizinkan akun.
user_info.allowed_output_formatsWajibArray of String["m3u8", "ts"]Daftar format wadah aliran yang didukung (m3u8, ts, mp4, mkv).
server_infoWajibObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Objek data yang memuat rincian server, porta koneksi, dan protokol siaran.

Titik Akhir dan Tindakan Katalog

Bidang / TagTingkatTipeNilai ContohDeskripsi
get_live_categoriesWajibArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Tindakan API untuk mengambil daftar kategori siaran saluran TV langsung.
get_vod_categoriesWajibArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Tindakan API untuk mengambil daftar kategori film video-on-demand (VOD).
get_series_categoriesWajibArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Tindakan API untuk mengambil daftar kategori serial televisi.
get_live_streamsWajibArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Tindakan API yang menampilkan saluran langsung secara penuh atau per kategori.
get_vod_streamsWajibArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Tindakan API yang menampilkan film VOD secara penuh atau berdasarkan kategori.
get_seriesWajibArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Tindakan API yang memberikan ikhtisar seluruh katalog serial 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 rincian serial secara mendalam termasuk musim dan episode.

Bidang Data Siaran Langsung dan VOD

Bidang / TagTingkatTipeNilai ContohDeskripsi
stream_idWajibInteger / String101Nomor pengenal numerik unik untuk saluran siaran langsung atau film VOD.
nameWajibString"TRT 1 HD"Nama saluran atau judul film yang ditampilkan di antarmuka pengguna.
stream_typeWajibString ("live" | "movie")"live"Tipe aliran: 'live' untuk saluran TV langsung atau 'movie' untuk film VOD.
stream_iconOpsionalURL (http/https)"https://stream.example.com:8080/images/101.png"Tautan langsung HTTPS ke logo saluran atau poster resmi film bersangkutan.
category_idWajibString / Integer"1"Pengenal kategori yang menempatkan item media ke dalam kelompok tertentu.
container_extensionWajibString without dot ("mp4", "mkv", "m3u8")"mp4"Ekstensi berkas video tanpa tanda titik di awal (seperti mp4, mkv, m3u8).
is_adultOpsionalInteger / String ("0" | "1")"0"Penanda konten dewasa: 1 jika ada batasan usia penonton, sebaliknya 0.

Bidang Data Serial dan Episode

Bidang / TagTingkatTipeNilai ContohDeskripsi
series_idWajibInteger / String303Nomor identifikasi numerik unik untuk serial televisi bersangkutan.
nameWajibString"Example Series"Judul resmi serial televisi dalam katalog perpustakaan tayangan.
coverOpsionalURL (http/https)"https://stream.example.com:8080/images/series303.png"Tautan langsung HTTPS ke gambar poster atau sampul serial televisi.
category_idWajibString / Integer"20"Pengenal kategori penempatan di dalam katalog serial televisi.
seasonWajibInteger / String1Nomor musim tayang tempat episode khusus ini bernaung.
episode_numWajibInteger / String1Nomor urut penayangan episode di dalam musim yang bersangkutan.
container_extensionWajibString without dot ("mp4", "mkv")"mp4"Ekstensi berkas video episode bersangkutan tanpa awalan titik.

Pola URL Aliran

TipeBidang / TagNilai Contoh
TV Langsung{server}/live/{username}/{password}/{stream_id}.m3u8https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
Film (VOD){server}/movie/{username}/{password}/{stream_id}.{container_extension}https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
Episode Serial{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

Tempelkan potongan M3U atau muatan JSON Xtream di bawah untuk memeriksa kompatibilitas dengan Mayk IP TV.

Daftar Periksa API Xtream Codes

  • Kembalikan user_info.auth = 1 dan status = Active untuk pelanggan aktif.
  • Kirim larik JSON kosong [] alih-alih null bila daftar katalog tidak berisi.
  • Pastikan setiap category_id mengarah ke kategori yang benar-benar ada.
  • Tuliskan container_extension tanpa tanda titik di depan (misal mp4 atau mkv).
  • Dukung permintaan HTTP 206 Partial Content untuk kelancaran penggulungan video.