{
"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"
}
}
Τεχνική τεκμηρίωση
Προδιαγραφή μορφής 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 / String | 101 | Μοναδικός αριθμητικός κωδικός του ζωντανού καναλιού ή της ταινίας. |
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 / String | 303 | Μοναδικός αριθμητικός κωδικός αναγνώρισης της τηλεοπτικής σειράς. |
name | Απαιτείται | String | "Example Series" | Επίσημος τίτλος της τηλεοπτικής σειράς στον κατάλογο εκπομπών. |
cover | Προαιρετικό | URL (http/https) | "https://stream.example.com:8080/images/series303.png" | Απευθείας διεύθυνση HTTPS για την αφίσα ή το εξώφυλλο της σειράς. |
category_id | Απαιτείται | String / Integer | "20" | Αναγνωριστικό κατηγορίας μέσα στον κατάλογο των τηλεοπτικών σειρών. |
season | Απαιτείται | Integer / String | 1 | Αριθμός κύκλου στον οποίο ανήκει το συγκεκριμένο επεισόδιο. |
episode_num | Απαιτείται | Integer / String | 1 | Αύξων αριθμός του επεισοδίου μέσα στον αντίστοιχο κύκλο. |
container_extension | Απαιτείται | String without dot ("mp4", "mkv") | "mp4" | Επέκταση αρχείου βίντεο του επεισοδίου χωρίς αρχική τελεία. |
Πρότυπα διευθύνσεων ροής
| Τύπος | Πεδίο / Ετικέτα | Παράδειγμα τιμής |
|---|---|---|
| Ζωντανή TV | {server}/live/{username}/{password}/{stream_id}.m3u8 | https://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 |
Δείγματα προτύπων
[
{
"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"
}
]
{
"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 για ομαλή κύλιση στο βίντεο.