Mayk IP TV

Referință tehnică

Specificația formatului Xtream Codes IPTV API

Specificație tehnică pentru Xtream Codes IPTV API. Puncte finale pentru autentificare, categorii, fluxuri live, VOD, seriale și validare JSON.

Arhitectura API-ului Xtream Codes

API-ul Xtream Codes oferă o interfață REST standardizată ce permite aplicațiilor IPTV să gestioneze autentificarea și cataloagele de conținut.

Autentificare și detalii cont

Aplicația client trimite credențialele către player_api.php și primește starea abonamentului, data expirării și detaliile serverului.

Operațiuni de catalog și secțiuni

Comenzile API dedicate permit descărcarea separată și eficientă a canalelor live, a filmelor la cerere și a serialelor TV.

Structură standardizată a legăturilor

Adresele fluxurilor urmează un model predictibil, incluzând extensia de container potrivită fiecărui tip media.

Câmpuri de autentificare

Câmp / EtichetăNivelTipValoare exempluDescriere
user_info.authObligatoriuInteger (1 = success)1Stare numerică de autentificare: 1 confirmă succesul, 0 respinge conectarea.
user_info.statusObligatoriuString ("Active")"Active"Starea contului de utilizator, de exemplu Active, Expired sau Banned.
user_info.exp_dateObligatoriuUnix Timestamp / null"1775000000"Marcaj temporal Unix ce precizează data la care expiră abonamentul.
user_info.max_connectionsObligatoriuString / Integer"2"Numărul maxim admis de fluxuri simultane permise pentru cont.
user_info.allowed_output_formatsObligatoriuArray of String["m3u8", "ts"]Lista formatelor de containere de streaming acceptate (m3u8, ts, mp4, mkv).
server_infoObligatoriuObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Obiect de date cu parametrii serverului, porturile de conectare și protocoalele.

Puncte finale și acțiuni de catalog

Câmp / EtichetăNivelTipValoare exempluDescriere
get_live_categoriesObligatoriuArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Acțiune API pentru preluarea categoriilor de canale TV live.
get_vod_categoriesObligatoriuArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Acțiune API pentru preluarea categoriilor de filme la cerere (VOD).
get_series_categoriesObligatoriuArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Acțiune API pentru preluarea categoriilor de seriale de televiziune.
get_live_streamsObligatoriuArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Acțiune API ce listează canalele live, general sau filtrate pe categorii.
get_vod_streamsObligatoriuArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Acțiune API ce listează filmele VOD, general sau filtrate pe categorii.
get_seriesObligatoriuArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Acțiune API care oferă catalogul general de seriale disponibile.
get_series_infoObligatoriuSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Acțiune API pentru detalii complete despre seriale, inclusiv sezoane și episoade.

Câmpuri de date pentru transmisiuni live și VOD

Câmp / EtichetăNivelTipValoare exempluDescriere
stream_idObligatoriuInteger / String101Număr de identificare unic pentru canalul live sau filmul la cerere.
nameObligatoriuString"TRT 1 HD"Numele afișat al canalului sau titlul filmului în interfața aplicației.
stream_typeObligatoriuString ("live" | "movie")"live"Tipul fluxului: 'live' pentru canale TV sau 'movie' pentru filme VOD.
stream_iconOpționalURL (http/https)"https://stream.example.com:8080/images/101.png"Adresă HTTPS directă către sigla canalului sau afișul filmului.
category_idObligatoriuString / Integer"1"Identificator de categorie care asociază elementul unei anumite secțiuni.
container_extensionObligatoriuString without dot ("mp4", "mkv", "m3u8")"mp4"Extensia fișierului video fără punct inițial (mp4, mkv, m3u8).
is_adultOpționalInteger / String ("0" | "1")"0"Marcaj pentru conținut destinat adulților: 1 dacă este restricționat, altfel 0.

Câmpuri de date pentru seriale și episoade

Câmp / EtichetăNivelTipValoare exempluDescriere
series_idObligatoriuInteger / String303Număr unic de identificare al serialului de televiziune.
nameObligatoriuString"Example Series"Titlul canonic al serialului în catalogul de producții TV.
coverOpționalURL (http/https)"https://stream.example.com:8080/images/series303.png"Adresă HTTPS directă către coperta sau afișul serialului.
category_idObligatoriuString / Integer"20"Identificator de categorie din catalogul de seriale.
seasonObligatoriuInteger / String1Numărul sezonului căruia îi aparține episodul respectiv.
episode_numObligatoriuInteger / String1Numărul de ordine al episodului în cadrul sezonului respectiv.
container_extensionObligatoriuString without dot ("mp4", "mkv")"mp4"Extensia fișierului video al episodului fără punct inițial.

Modele de adrese URL pentru streamuri

TipCâmp / EtichetăValoare exemplu
Televiziune în direct{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
Episod de serial{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Șabloane demonstrative

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

Verificator interactiv de format

Inserați fragmentul M3U sau răspunsul JSON Xtream mai jos pentru a verifica compatibilitatea cu Mayk IP TV.

Listă de verificare Xtream Codes API

  • Trimiteți user_info.auth = 1 și status = Active pentru abonații activi.
  • Returnați o matrice JSON goală [] în loc de null în cazul listelor fără conținut.
  • Asigurați-vă că fiecare category_id face trimitere la o categorie existentă.
  • Furnizați container_extension fără punct la început (de exemplu mp4 sau mkv).
  • Acceptați cereri HTTP 206 Partial Content pentru derularea cursivă a conținutului.