{
"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"
}
}
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 / Tag | Tingkat | Tipe | Nilai Contoh | Deskripsi |
|---|---|---|---|---|
user_info.auth | Wajib | Integer (1 = success) | 1 | Status verifikasi numerik: 1 menandakan berhasil, 0 menandakan akses ditolak. |
user_info.status | Wajib | String ("Active") | "Active" | Status akun pengguna saat ini, misalnya Active, Expired, atau Banned. |
user_info.exp_date | Wajib | Unix Timestamp / null | "1775000000" | Stempel waktu Unix yang menunjukkan batas akhir masa berlaku langganan akun. |
user_info.max_connections | Wajib | String / Integer | "2" | Jumlah batas sambungan streaming simultan maksimum yang diizinkan akun. |
user_info.allowed_output_formats | Wajib | Array of String | ["m3u8", "ts"] | Daftar format wadah aliran yang didukung (m3u8, ts, mp4, mkv). |
server_info | Wajib | Object | {"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 / Tag | Tingkat | Tipe | Nilai Contoh | Deskripsi |
|---|---|---|---|---|
get_live_categories | Wajib | Array of Category Objects | [{"category_id":"1","category_name":"News","parent_id":0}] | Tindakan API untuk mengambil daftar kategori siaran saluran TV langsung. |
get_vod_categories | Wajib | Array 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_categories | Wajib | Array of Category Objects | [{"category_id":"20","category_name":"Drama","parent_id":0}] | Tindakan API untuk mengambil daftar kategori serial televisi. |
get_live_streams | Wajib | Array 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_streams | Wajib | Array 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_series | Wajib | Array of Series Objects | [{"series_id":303,"name":"Example Series","category_id":"20"}] | Tindakan API yang memberikan ikhtisar seluruh katalog serial yang tersedia. |
get_series_info | Wajib | Series 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 / Tag | Tingkat | Tipe | Nilai Contoh | Deskripsi |
|---|---|---|---|---|
stream_id | Wajib | Integer / String | 101 | Nomor pengenal numerik unik untuk saluran siaran langsung atau film VOD. |
name | Wajib | String | "TRT 1 HD" | Nama saluran atau judul film yang ditampilkan di antarmuka pengguna. |
stream_type | Wajib | String ("live" | "movie") | "live" | Tipe aliran: 'live' untuk saluran TV langsung atau 'movie' untuk film VOD. |
stream_icon | Opsional | URL (http/https) | "https://stream.example.com:8080/images/101.png" | Tautan langsung HTTPS ke logo saluran atau poster resmi film bersangkutan. |
category_id | Wajib | String / Integer | "1" | Pengenal kategori yang menempatkan item media ke dalam kelompok tertentu. |
container_extension | Wajib | String without dot ("mp4", "mkv", "m3u8") | "mp4" | Ekstensi berkas video tanpa tanda titik di awal (seperti mp4, mkv, m3u8). |
is_adult | Opsional | Integer / String ("0" | "1") | "0" | Penanda konten dewasa: 1 jika ada batasan usia penonton, sebaliknya 0. |
Bidang Data Serial dan Episode
| Bidang / Tag | Tingkat | Tipe | Nilai Contoh | Deskripsi |
|---|---|---|---|---|
series_id | Wajib | Integer / String | 303 | Nomor identifikasi numerik unik untuk serial televisi bersangkutan. |
name | Wajib | String | "Example Series" | Judul resmi serial televisi dalam katalog perpustakaan tayangan. |
cover | Opsional | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | Tautan langsung HTTPS ke gambar poster atau sampul serial televisi. |
category_id | Wajib | String / Integer | "20" | Pengenal kategori penempatan di dalam katalog serial televisi. |
season | Wajib | Integer / String | 1 | Nomor musim tayang tempat episode khusus ini bernaung. |
episode_num | Wajib | Integer / String | 1 | Nomor urut penayangan episode di dalam musim yang bersangkutan. |
container_extension | Wajib | String without dot ("mp4", "mkv") | "mp4" | Ekstensi berkas video episode bersangkutan tanpa awalan titik. |
Pola URL Aliran
| Tipe | Bidang / Tag | Nilai Contoh |
|---|---|---|
| TV Langsung | {server}/live/{username}/{password}/{stream_id}.m3u8 | https://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
[
{
"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
}
]
}
}
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.