Mayk IP TV

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 / TagPoziomTypPrzykładowa wartośćOpis
user_info.authWymaganeInteger (1 = success)1Status weryfikacji: 1 oznacza pomyślne uwierzytelnienie, 0 oznacza brak dostępu.
user_info.statusWymaganeString ("Active")"Active"Status konta użytkownika, na przykład Active, Expired lub Banned.
user_info.exp_dateWymaganeUnix Timestamp / null"1775000000"Znacznik czasu Unix określający termin wygaśnięcia subskrypcji.
user_info.max_connectionsWymaganeString / Integer"2"Maksymalna dozwolona liczba jednoczesnych połączeń strumieniowych dla konta.
user_info.allowed_output_formatsWymaganeArray of String["m3u8", "ts"]Lista obsługiwanych formatów kontenerów strumienia (m3u8, ts, mp4, mkv).
server_infoWymaganeObject{"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 / TagPoziomTypPrzykładowa wartośćOpis
get_live_categoriesWymaganeArray 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_categoriesWymaganeArray 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_categoriesWymaganeArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Akcja API pobierająca listę kategorii seriali telewizyjnych.
get_live_streamsWymaganeArray 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_streamsWymaganeArray 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_seriesWymaganeArray 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_infoWymaganeSeries 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 / TagPoziomTypPrzykładowa wartośćOpis
stream_idWymaganeInteger / String101Unikalny identyfikator numeryczny kanału na żywo lub filmu VOD.
nameWymaganeString"TRT 1 HD"Wyświetlana nazwa kanału lub tytuł filmu w interfejsie aplikacji.
stream_typeWymaganeString ("live" | "movie")"live"Typ strumienia: 'live' dla kanałów telewizyjnych lub 'movie' dla filmów.
stream_iconOpcjonalneURL (http/https)"https://stream.example.com:8080/images/101.png"Bezpośredni adres URL do logo kanału lub plakatu filmu przez HTTPS.
category_idWymaganeString / Integer"1"Identyfikator kategorii przypisujący strumień do określonej grupy.
container_extensionWymaganeString without dot ("mp4", "mkv", "m3u8")"mp4"Rozszerzenie kontenera wideo bez kropki początkowej (mp4, mkv, m3u8).
is_adultOpcjonalneInteger / 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 / TagPoziomTypPrzykładowa wartośćOpis
series_idWymaganeInteger / String303Unikalny identyfikator numeryczny serialu telewizyjnego.
nameWymaganeString"Example Series"Kanoniczny tytuł serialu w katalogu produkcji telewizyjnych.
coverOpcjonalneURL (http/https)"https://stream.example.com:8080/images/series303.png"Bezpośredni adres URL do okładki lub plakatu serialu.
category_idWymaganeString / Integer"20"Identyfikator kategorii wewnątrz katalogu seriali.
seasonWymaganeInteger / String1Numer sezonu, do którego należy dany odcinek.
episode_numWymaganeInteger / String1Numer porządkowy odcinka w ramach danego sezonu.
container_extensionWymaganeString without dot ("mp4", "mkv")"mp4"Rozszerzenie pliku wideo odcinka bez kropki początkowej.

Wzorce adresów URL strumieni

TypPole / TagPrzykładowa wartość
Telewizja na żywo{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
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

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

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.