Mayk IP TV

Τεχνική τεκμηρίωση

Προδιαγραφή μορφής Xtream Codes IPTV API

Τεχνική προδιαγραφή για το Xtream Codes IPTV API. Τελικά σημεία ταυτοποίησης, κατηγοριών, ζωντανών ροών, VOD, σειρών και επαλήθευση JSON.

Αρχιτεκτονική του Xtream Codes API

Το Xtream Codes API παρέχει μια δομημένη διεπαφή REST που επιτρέπει σε εφαρμογές IPTV να διαχειρίζονται τη σύνδεση και τους καταλόγους περιεχομένου.

Ταυτοποίηση και προφίλ χρήστη

Η εφαρμογή στέλνει στοιχεία σύνδεσης στο player_api.php και λαμβάνει την κατάσταση συνδρομής, τη λήξη και τις ρυθμίσεις του διακομιστή.

Ενέργειες καταλόγου και πλοήγηση

Ξεχωριστές κλήσεις API επιτρέπουν την ανεξάρτητη λήψη ζωντανών καναλιών, ταινιών κατά παραγγελία (VOD) και τηλεοπτικών σειρών.

Ομοιόμορφη δομή συνδέσμων

Οι διευθύνσεις ροής ακολουθούν προβλέψιμη μορφή με τη σωστή επέκταση αρχείου για κάθε ξεχωριστό τύπο πολυμέσων.

Πεδία ταυτοποίησης

Πεδίο / ΕτικέταΕπίπεδοΤύποςΠαράδειγμα τιμήςΠεριγραφή
user_info.authΑπαιτείταιInteger (1 = success)1Αριθμητική κατάσταση ταυτοποίησης: 1 για έγκριση πρόσβασης, 0 για απόρριψη.
user_info.statusΑπαιτείταιString ("Active")"Active"Κατάσταση του λογαριασμού χρήστη, για παράδειγμα Active, Expired ή Banned.
user_info.exp_dateΑπαιτείταιUnix Timestamp / null"1775000000"Χρονική σήμανση Unix που υποδεικνύει την ημερομηνία λήξης της συνδρομής.
user_info.max_connectionsΑπαιτείταιString / Integer"2"Μέγιστος επιτρεπόμενος αριθμός ταυτόχρονων ροών για τον λογαριασμό.
user_info.allowed_output_formatsΑπαιτείταιArray of String["m3u8", "ts"]Λίστα υποστηριζόμενων μορφών περιέκτη ροής (m3u8, ts, mp4, mkv).
server_infoΑπαιτείταιObject{"url":"stream.example.com","port":"8080","https_port":"8443","server_protocol":"https"}Αντικείμενο δεδομένων με τις θύρες του διακομιστή και τα πρωτόκολλα ροής.

Τελικά σημεία και ενέργειες καταλόγου

Πεδίο / ΕτικέταΕπίπεδοΤύποςΠαράδειγμα τιμήςΠεριγραφή
get_live_categoriesΑπαιτείταιArray of Category Objects[{"category_id":"1","category_name":"News","parent_id":0}]Ενέργεια API για τη λήψη των κατηγοριών ζωντανής τηλεόρασης.
get_vod_categoriesΑπαιτείταιArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]Ενέργεια API για τη λήψη των κατηγοριών ταινιών κατά παραγγελία (VOD).
get_series_categoriesΑπαιτείταιArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]Ενέργεια API για τη λήψη των κατηγοριών τηλεοπτικών σειρών.
get_live_streamsΑπαιτείταιArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]Ενέργεια API που εμφανίζει τα ζωντανά κανάλια συνολικά ή ανά κατηγορία.
get_vod_streamsΑπαιτείταιArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]Ενέργεια API που εμφανίζει τις ταινίες συνολικά ή ανά κατηγορία.
get_seriesΑπαιτείταιArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]Ενέργεια API που παρέχει τον γενικό κατάλογο των διαθέσιμων σειρών.
get_series_infoΑπαιτείταιSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}Ενέργεια API για αναλυτικές λεπτομέρειες σειράς, συμπεριλαμβανομένων κύκλων και επεισοδίων.

Πεδία δεδομένων ζωντανής ροής και VOD

Πεδίο / ΕτικέταΕπίπεδοΤύποςΠαράδειγμα τιμήςΠεριγραφή
stream_idΑπαιτείταιInteger / String101Μοναδικός αριθμητικός κωδικός του ζωντανού καναλιού ή της ταινίας.
nameΑπαιτείταιString"TRT 1 HD"Εμφανιζόμενος τίτλος του καναλιού ή της ταινίας στη διεπαφή χρήστη.
stream_typeΑπαιτείταιString ("live" | "movie")"live"Τύπος ροής: 'live' για τηλεοπτικά κανάλια ή 'movie' για ταινίες VOD.
stream_iconΠροαιρετικόURL (http/https)"https://stream.example.com:8080/images/101.png"Απευθείας διεύθυνση HTTPS για το λογότυπο του καναλιού ή την αφίσα της ταινίας.
category_idΑπαιτείταιString / Integer"1"Αναγνωριστικό κατηγορίας που κατατάσσει το στοιχείο σε συγκεκριμένη ομάδα.
container_extensionΑπαιτείταιString without dot ("mp4", "mkv", "m3u8")"mp4"Επέκταση αρχείου βίντεο χωρίς αρχική τελεία (mp4, mkv, m3u8).
is_adultΠροαιρετικόInteger / String ("0" | "1")"0"Ένδειξη περιεχομένου ενηλίκων: 1 εάν υπάρχει ηλικιακός περιορισμός, αλλιώς 0.

Πεδία δεδομένων σειρών και επεισοδίων

Πεδίο / ΕτικέταΕπίπεδοΤύποςΠαράδειγμα τιμήςΠεριγραφή
series_idΑπαιτείταιInteger / String303Μοναδικός αριθμητικός κωδικός αναγνώρισης της τηλεοπτικής σειράς.
nameΑπαιτείταιString"Example Series"Επίσημος τίτλος της τηλεοπτικής σειράς στον κατάλογο εκπομπών.
coverΠροαιρετικόURL (http/https)"https://stream.example.com:8080/images/series303.png"Απευθείας διεύθυνση HTTPS για την αφίσα ή το εξώφυλλο της σειράς.
category_idΑπαιτείταιString / Integer"20"Αναγνωριστικό κατηγορίας μέσα στον κατάλογο των τηλεοπτικών σειρών.
seasonΑπαιτείταιInteger / String1Αριθμός κύκλου στον οποίο ανήκει το συγκεκριμένο επεισόδιο.
episode_numΑπαιτείταιInteger / String1Αύξων αριθμός του επεισοδίου μέσα στον αντίστοιχο κύκλο.
container_extensionΑπαιτείταιString without dot ("mp4", "mkv")"mp4"Επέκταση αρχείου βίντεο του επεισοδίου χωρίς αρχική τελεία.

Πρότυπα διευθύνσεων ροής

ΤύποςΠεδίο / ΕτικέταΠαράδειγμα τιμής
Ζωντανή TV{server}/live/{username}/{password}/{stream_id}.m3u8https://stream.example.com:8080/live/demo_user/demo_pass/101.m3u8
Ταινία (VOD){server}/movie/{username}/{password}/{stream_id}.{container_extension}https://stream.example.com:8080/movie/demo_user/demo_pass/202.mp4
Επεισόδιο σειράς{server}/series/{username}/{password}/{episode_id}.{container_extension}https://stream.example.com:8080/series/demo_user/demo_pass/30301.mp4

Δείγματα προτύπων

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

Διαδραστικός έλεγχος μορφής

Επικολλήστε το απόσπασμα M3U ή την απόκριση JSON του Xtream παρακάτω για έλεγχο συμβατότητας με το Mayk IP TV.

Λίστα ελέγχου Xtream Codes API

  • Επιστρέφετε user_info.auth = 1 και status = Active για έγκυρους συνδρομητές.
  • Στέλνετε κενό πίνακα JSON [] αντί για null σε περιπτώσεις άδειων καταλόγων.
  • Επαληθεύετε ότι κάθε category_id αντιστοιχεί σε υπαρκτή κατηγορία.
  • Δηλώνετε το container_extension χωρίς τελεία στην αρχή (π.χ. mp4 ή mkv).
  • Υποστηρίζετε αιτήματα HTTP 206 Partial Content για ομαλή κύλιση στο βίντεο.