{
"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"
}
}
Dokumentacja techniczna
Specyfikacja formatu Xtream Codes IPTV API
Specyfikacja techniczna Xtream Codes IPTV API. Punkty końcowe dla uwierzytelniania, kategorii, transmisji na żywo, VOD, seriali i walidacji JSON.
Architektura API Xtream Codes
API Xtream Codes stanowi ustrukturyzowany protokół REST, umożliwiający odtwarzaczom IPTV pobieranie autoryzacji oraz katalogów zawartości.
Przebieg uwierzytelniania
Aplikacja przesyła dane logowania do player_api.php, otrzymując status konta, datę ważności subskrypcji oraz parametry serwera.
Akcje katalogowe i kategorie
Dedykowane zapytania API pozwalają na selektywne pobieranie kanałów na żywo, filmów VOD oraz wieloodcinkowych seriali.
Struktura adresów URL
Łącza strumieniowe opierają się na przewidywalnym wzorcu ze wskazanym rozszerzeniem kontenera dla danego typu mediów.
Pola uwierzytelniania
| Pole / Tag | Poziom | Typ | Przykładowa wartość | Opis |
|---|---|---|---|---|
user_info.auth | Wymagane | Integer (1 = success) | 1 | Status weryfikacji: 1 oznacza pomyślne uwierzytelnienie, 0 oznacza brak dostępu. |
user_info.status | Wymagane | String ("Active") | "Active" | Status konta użytkownika, na przykład Active, Expired lub Banned. |
user_info.exp_date | Wymagane | Unix Timestamp / null | "1775000000" | Znacznik czasu Unix określający termin wygaśnięcia subskrypcji. |
user_info.max_connections | Wymagane | String / Integer | "2" | Maksymalna dozwolona liczba jednoczesnych połączeń strumieniowych dla konta. |
user_info.allowed_output_formats | Wymagane | Array of String | ["m3u8", "ts"] | Lista obsługiwanych formatów kontenerów strumienia (m3u8, ts, mp4, mkv). |
server_info | Wymagane | Object | {"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"} | Węzeł danych zawierający porty serwera, protokoły oraz konfigurację strumieniowania. |
Punkty końcowe i akcje katalogu
| Pole / Tag | Poziom | Typ | Przykładowa wartość | Opis |
|---|---|---|---|---|
get_live_categories | Wymagane | Array of Category Objects | [{"category_id":"1","category_name":"News","parent_id":0}] | Akcja API pobierająca listę kategorii kanałów telewizyjnych na żywo. |
get_vod_categories | Wymagane | Array of Category Objects | [{"category_id":"10","category_name":"Action","parent_id":0}] | Akcja API pobierająca listę kategorii filmów na żądanie (VOD). |
get_series_categories | Wymagane | Array of Category Objects | [{"category_id":"20","category_name":"Drama","parent_id":0}] | Akcja API pobierająca listę kategorii seriali telewizyjnych. |
get_live_streams | Wymagane | Array of Live Stream Objects | [{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}] | Akcja API zwracająca kanały na żywo, ogólnie lub według kategorii. |
get_vod_streams | Wymagane | Array of VOD Stream Objects | [{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}] | Akcja API zwracająca filmy VOD, ogólnie lub według kategorii. |
get_series | Wymagane | Array of Series Objects | [{"series_id":303,"name":"Example Series","category_id":"20"}] | Akcja API udostępniająca ogólny katalog dostępnych seriali. |
get_series_info | Wymagane | Series Detail Object (episodes map) | {"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}} | Akcja API zwracająca szczegółowe dane serialu wraz z sezonami i odcinkami. |
Pola danych strumieni na żywo i VOD
| Pole / Tag | Poziom | Typ | Przykładowa wartość | Opis |
|---|---|---|---|---|
stream_id | Wymagane | Integer / String | 101 | Unikalny identyfikator numeryczny kanału na żywo lub filmu VOD. |
name | Wymagane | String | "TRT 1 HD" | Wyświetlana nazwa kanału lub tytuł filmu w interfejsie aplikacji. |
stream_type | Wymagane | String ("live" | "movie") | "live" | Typ strumienia: 'live' dla kanałów telewizyjnych lub 'movie' dla filmów. |
stream_icon | Opcjonalne | URL (http/https) | "https://stream.example.com:8080/images/101.png" | Bezpośredni adres URL do logo kanału lub plakatu filmu przez HTTPS. |
category_id | Wymagane | String / Integer | "1" | Identyfikator kategorii przypisujący strumień do określonej grupy. |
container_extension | Wymagane | String without dot ("mp4", "mkv", "m3u8") | "mp4" | Rozszerzenie kontenera wideo bez kropki początkowej (mp4, mkv, m3u8). |
is_adult | Opcjonalne | Integer / String ("0" | "1") | "0" | Oznaczenie treści dla dorosłych: 1 przy ograniczeniu wiekowym, w przeciwnym razie 0. |
Pola danych seriali i odcinków
| Pole / Tag | Poziom | Typ | Przykładowa wartość | Opis |
|---|---|---|---|---|
series_id | Wymagane | Integer / String | 303 | Unikalny identyfikator numeryczny serialu telewizyjnego. |
name | Wymagane | String | "Example Series" | Kanoniczny tytuł serialu w katalogu produkcji telewizyjnych. |
cover | Opcjonalne | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | Bezpośredni adres URL do okładki lub plakatu serialu. |
category_id | Wymagane | String / Integer | "20" | Identyfikator kategorii wewnątrz katalogu seriali. |
season | Wymagane | Integer / String | 1 | Numer sezonu, do którego należy dany odcinek. |
episode_num | Wymagane | Integer / String | 1 | Numer porządkowy odcinka w ramach danego sezonu. |
container_extension | Wymagane | String without dot ("mp4", "mkv") | "mp4" | Rozszerzenie pliku wideo odcinka bez kropki początkowej. |
Wzorce adresów URL strumieni
| Typ | Pole / Tag | Przykładowa wartość |
|---|---|---|
| Telewizja na żywo | {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 |
| Odcinek serialu | {server}/series/{username}/{password}/{episode_id}.{container_extension} | https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4 |
Przykładowe szablony
[
{
"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
}
]
}
}
Interaktywny walidator formatu
Wklej poniżej fragment M3U lub odpowiedź JSON Xtream, aby sprawdzić zgodność z Mayk IP TV.
Lista kontrolna API Xtream Codes
- Zwracaj user_info.auth = 1 oraz status = Active dla aktywnych abonentów.
- Wysyłaj pustą tablicę JSON [] zamiast null w przypadku braku pozycji.
- Upewnij się, że każdy category_id wskazuje na istniejącą kategorię.
- Podawaj container_extension bez kropki na początku (np. mp4 lub mkv).
- Obsługuj zapytania HTTP 206 Partial Content dla płynnego przewijania wideo.