Mayk IP TV

Tehniline teatmik

Xtream Codes IPTV API vormingu spetsifikatsioon

Xtream Codes IPTV API tehniline spetsifikatsioon. Lõpp-punktid autentimiseks, kategooriateks, otsekanaliteks, filmideks, sarjadeks ja JSON kontrolliks.

Xtream Codes API arhitektuur

Xtream Codes API pakub struktureeritud REST liidest, mis võimaldab IPTV klientidel turvaliselt autentida ja katalooge pärida.

Autentimine ja kontoteave

Klient saadab sisselogimisandmed aadressile player_api.php ning saab vastuseks tellimuse kehtivuse ja serveri parameetrid.

Kataloogi toimingud ja jaotus

Eraldi API toimingud võimaldavad tõhusalt alla laadida otseülekannete, VOD filmide ja sarjade nimekirju.

Ühtne URL struktuur

Voogedastuse URL-id järgivad prognoositavat malli vastava faililaiendiga igale meediatüübile.

Autentimise väljad

Väli / SiltTaseTüüpNäidisväärtusKirjeldus
user_info.authNõutavInteger (1 = success)1Numbriline autentimisolek: 1 kinnitab edukat sisenemist, 0 tähistab tagasilükkamist.
user_info.statusNõutavString ("Active")"Active"Kasutajakonto staatus, näiteks Active, Expired või Banned.
user_info.exp_dateNõutavUnix Timestamp / null"1775000000"Unix ajatempel, mis näitab kasutaja tellimuse aegumiskuupäeva.
user_info.max_connectionsNõutavString / Integer"2"Kontole lubatud üheaegsete meediavoogude maksimaalne arv.
user_info.allowed_output_formatsNõutavArray of String["m3u8", "ts"]Toetatud voo konteinervormingute loend (m3u8, ts, mp4, mkv).
server_infoNõutavObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Andmeobjekt serveri seadete, ühendusportide ja voogedastusprotokollidega.

Kataloogi lõpp-punktid ja toimingud

Väli / SiltTaseTüüpNäidisväärtusKirjeldus
get_live_categoriesNõutavArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]API toiming otse-telekanalite kategooriate loetelu pärimiseks.
get_vod_categoriesNõutavArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]API toiming tellitavate filmide kategooriate loetelu pärimiseks.
get_series_categoriesNõutavArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]API toiming telesarjade kategooriate loetelu pärimiseks.
get_live_streamsNõutavArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]API toiming, mis kuvab otsekanalid üldiselt või kategooriate kaupa.
get_vod_streamsNõutavArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]API toiming, mis kuvab filmid üldiselt või kategooriate kaupa.
get_seriesNõutavArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]API toiming, mis tagab ülevaate kõigist saadaolevatest sarjadest.
get_series_infoNõutavSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}API toiming sarja üksikasjalike andmete saamiseks koos hooaegade ja osadega.

Otseülekande ja VOD andmeväljad

Väli / SiltTaseTüüpNäidisväärtusKirjeldus
stream_idNõutavInteger / String101Otsekanali või filmi unikaalne numbriline identifikaator.
nameNõutavString"TRT 1 HD"Kanali või filmi kuvatav pealkiri kasutajaliideses.
stream_typeNõutavString ("live" | "movie")"live"Voo tüüp: 'live' telekanalite jaoks või 'movie' VOD filmide jaoks.
stream_iconValikulineURL (http/https)"https://stream.example.com:8080/images/101.png"Otsene HTTPS aadress kanali logole või filmi plakatile.
category_idNõutavString / Integer"1"Kategooria ID, mis seob sisu vastava kategooriaga.
container_extensionNõutavString without dot ("mp4", "mkv", "m3u8")"mp4"Videofaili laiend ilma alguspunktita (mp4, mkv, m3u8).
is_adultValikulineInteger / String ("0" | "1")"0"Täiskasvanute sisu märgis: 1 vanusepiiranguga sisu puhul, muidu 0.

Sarjade ja osade andmeväljad

Väli / SiltTaseTüüpNäidisväärtusKirjeldus
series_idNõutavInteger / String303Telesarja unikaalne numbriline identifikaator.
nameNõutavString"Example Series"Telesarja ametlik pealkiri sarjade kataloogis.
coverValikulineURL (http/https)"https://stream.example.com:8080/images/series303.png"Otsene HTTPS aadress sarja kaanepildile või plakatile.
category_idNõutavString / Integer"20"Kategooria identifikaator sarjade nimekirjas.
seasonNõutavInteger / String1Hooaja number, kuhu konkreetne osa kuulub.
episode_numNõutavInteger / String1Osa järjekorranumber vastava hooaja sees.
container_extensionNõutavString without dot ("mp4", "mkv")"mp4"Osa videofaili laiend ilma alguspunktita.

Voogedastuse URL-ide mustrid

TüüpVäli / SiltNäidisväärtus
Otse-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
Sarja osa{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Näidismallid

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

Interaktiivne vormingu kontrollija

Asetage oma M3U katkend või Xtream JSON vastus allpool, et kontrollida ühilduvust Mayk IP TV-ga.

Xtream Codes API kontroll-leht

  • Tagastage user_info.auth = 1 ja status = Active kehtivate tellijate puhul.
  • Saatke tühja nimekirja korral tühi JSON massiiv [] väärtuse null asemel.
  • Kontrollige, et iga category_id vastaks kehtivale kategooriale.
  • Esitage container_extension ilma punktita ees (nt mp4 või mkv).
  • Toetage päringuid HTTP 206 Partial Content sujuva edasi-tagasi kerimise jaoks.