Mayk IP TV

Teknik API Referansı

Xtream Codes player_api.php Standartları

Xtream Codes API uç noktaları, kimlik doğrulama yanıtı, canlı, VOD ve dizi katalog isteklerinin standart veri yapılarını inceleyin.

Kimlik Doğrulama ve Sunucu Bilgisi

GET /player_api.php?username=...&password=... isteği user_info ve server_info nesnelerini içeren bir JSON döndürür. user_info.auth değerinin 1 ve status değerinin 'Active' olması gereklidir.

Altı Temel Katalog Aksiyonu

Uygulama get_live_categories, get_vod_categories, get_series_categories ile kategorileri, get_live_streams, get_vod_streams ve get_series ile içerik listelerini çeker. Boş listeler boş JSON dizisi [] döndürmelidir.

Kategori Bütünlüğü ve Yetim Kayıtlar

Her akış ve dizi öğesinin category_id değeri, ilgili kategori listesinde mevcut bir ID ile eşleşmelidir. Tanımsız kategori ID'leri içeriklerin kaybolmasına neden olabilir.

Dizi ve Bölüm Detay Yapısı

Dizi detayları get_series_info&series_id=... ile alınır. Yanıt içindeki episodes nesnesi sezon numaralarını anahtar olarak kullanan bölüm listeleri haritası içermelidir.

Oynatma URL Yapısı ve Range Desteği

Canlı yayınlar /live/, filmler /movie/, dizi bölümleri /series/ yolları üzerinden sunulur. VOD ve dizi içeriklerinde ileri-geri sarma için HTTP 206 Partial Content desteği şarttır.

Kimlik Doğrulama Alanları

Alan / EtiketSeviyeTürÖrnek DeğerAçıklama
user_info.authZorunluInteger (1 = success)1Kimlik doğrulama kodu: 1 değeri girişin başarılı olduğunu gösterir.
user_info.statusZorunluString ("Active")"Active"Hesap durumu; yayınlara erişim için 'Active' olmalıdır.
user_info.exp_dateZorunluUnix Timestamp / null"1775000000"Hesap bitiş tarihi Unix zaman damgası; süresiz için null döner.
user_info.max_connectionsZorunluString / Integer"2"İzin verilen maksimum eşzamanlı aktif yayın bağlantısı sayısı.
user_info.allowed_output_formatsZorunluArray of String["m3u8", "ts"]Sunucunun desteklediği yayın formatları listesi (m3u8, ts, mp4, mkv).
server_infoZorunluObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Sunucu adresi, bağlantı noktaları ve protokol meta veri nesnesi.

Katalog İstekleri ve Aksiyonlar

Alan / EtiketSeviyeTürÖrnek DeğerAçıklama
get_live_categoriesZorunluArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Canlı TV kategori nesnelerini döndüren katalog aksiyonu.
get_vod_categoriesZorunluArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Seç-izle (VOD) film kategori nesnelerini döndüren katalog aksiyonu.
get_series_categoriesZorunluArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Dizi kategori nesnelerini döndüren katalog aksiyonu.
get_live_streamsZorunluArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Tüm canlı yayın kanallarını veya kategori filtreli listeyi döndürür.
get_vod_streamsZorunluArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Tüm film yayınlarını veya kategori filtreli listeyi döndürür.
get_seriesZorunluArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Dizi genel bakış kayıtlarını döndüren katalog aksiyonu.
get_series_infoZorunluSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Sezon özetlerini ve bölüm haritasını içeren detaylı dizi aksiyonu.

Canlı Yayın ve VOD Veri Alanları

Alan / EtiketSeviyeTürÖrnek DeğerAçıklama
stream_idZorunluInteger / String101Canlı yayın veya film için benzersiz sayısal veya metin akış kimliği.
nameZorunluString"TRT 1 HD"Televizyon kanalının veya seç-izle filmin görünen adı.
stream_typeZorunluString ("live" | "movie")"live"Yayın sınıflandırma türü: Canlı için 'live', film için 'movie'.
stream_iconİsteğe BağlıURL (http/https)"https://stream.example.com:8080/images/101.png"Kanal logosu veya film afişine doğrudan HTTP/HTTPS bağlantısı.
category_idZorunluString / Integer"1"Kategori listesindeki geçerli bir kaydı işaret eden kategori kimliği.
container_extensionZorunluString without dot ("mp4", "mkv", "m3u8")"mp4"Noktasız hedef dosya biçimi uzantısı (mp4, mkv, m3u8).
is_adultİsteğe BağlıInteger / String ("0" | "1")"0"Yaş kısıtlaması göstergesi: '1' yetişkin içeriği belirtir.

Dizi ve Bölüm Veri Alanları

Alan / EtiketSeviyeTürÖrnek DeğerAçıklama
series_idZorunluInteger / String303Dizi kaydına ait benzersiz kimlik numarası veya metni.
nameZorunluString"Example Series"Televizyon dizisinin standart adı.
coverİsteğe BağlıURL (http/https)"https://stream.example.com:8080/images/series303.png"Dizinin afiş görseline doğrudan HTTP/HTTPS bağlantısı.
category_idZorunluString / Integer"20"Dizi kategorileri listesindeki bir kategoriyle eşleşen kimlik.
seasonZorunluInteger / String1Bölümün ait olduğu sezon numarası.
episode_numZorunluInteger / String1Bölümün sezon içindeki sıra numarası.
container_extensionZorunluString without dot ("mp4", "mkv")"mp4"Dizi bölümü için noktasız video dosya uzantısı.

Yayın URL Şablonları

TürAlan / EtiketÖrnek Değer
Canlı TV{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
Dizi Bölümü{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Örnek Şablonlar

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

Etkileşimli Format Denetleyicisi

M3U veya Xtream verinizi yapıştırarak Mayk IP TV ayrıştırma kurallarına uygunluğunu hemen test edin.

Xtream API Uyumluluk Kontrol Listesi

  • Doğru giriş bilgilerinde user_info.auth değerini 1 ve status değerini Active olarak döndürün.
  • Kategori veya akış bulunmadığında null veya nesne yerine boş JSON dizisi [] döndürün.
  • Tüm stream_id ve category_id değerlerinin tutarlı ve geçerli olduğunu doğrulayın.
  • container_extension değerini başında nokta olmadan (ör. mp4, mkv) gönderin.
  • VOD ve dizi oynatımında HTTP 206 Range isteklerini eksiksiz destekleyin.