Mayk IP TV

תיעוד טכני

מפרט פורמט Xtream Codes IPTV API

מפרט טכני עבור Xtream Codes IPTV API. נקודות קצה לאימות, קטגוריות, שידורים חיים, VOD, סדרות ובדיקת JSON.

ארכיטקטורת ממשק Xtream Codes API

ממשק Xtream Codes מציע מבנה REST מוגדר המאפשר לנגני IPTV לנהל כניסה למערכת ולמשוך קטלוגי מדיה ביעילות ובבטחה.

אימות ופרטי חשבון המנוי

האפליקציה שולחת את פרטי הזיהוי לכתובת player_api.php ומקבלת את מצב המנוי, תאריך התפוגה והגדרות השרת.

פעולות קטלוג וחלוקה לקטגוריות

קריאות ממשק ייעודיות מאפשרות הורדה נפרדת ומהירה של ערוצים חיים, סרטי VOD וסדרות טלוויזיה.

מבנה אחיד של כתובות שידור

כתובות ה-URL של השידורים בנויות לפי תבנית אחידה עם סיומת הקובץ המתאימה לכל סוג מדיה.

שדות אימות

שדה / תגיתרמהסוגערך לדוגמהתיאור
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}]פעולת ממשק לשליפת רשימת הקטגוריות של ערוצי הטלוויזיה החיים.
get_vod_categoriesחובהArray of Category Objects[{"category_id":"10","category_name":"Action","parent_id":0}]פעולת ממשק לשליפת קטגוריות סרטי הקולנוע לפי דרישה (VOD).
get_series_categoriesחובהArray of Category Objects[{"category_id":"20","category_name":"Drama","parent_id":0}]פעולת ממשק לשליפת קטגוריות סדרות הטלוויזיה.
get_live_streamsחובהArray of Live Stream Objects[{"stream_id":101,"name":"TRT 1 HD","stream_type":"live","category_id":"1"}]פעולת ממשק המחזירה את הערוצים החיים במלואם או מסוננים לפי קטגוריה.
get_vod_streamsחובהArray of VOD Stream Objects[{"stream_id":202,"name":"Example Movie","container_extension":"mp4","category_id":"10"}]פעולת ממשק המחזירה את סרטי ה-VOD במלואם או מסוננים לפי קטגוריה.
get_seriesחובהArray of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]פעולת ממשק המספקת את הקטלוג הכללי של סדרות הטלוויזיה הזמינות.
get_series_infoחובהSeries Detail Object (episodes map){"info":{"name":"Example Series"},"episodes":{"1":[{"id":"30301","episode_num":1,"title":"Episode 1"}]}}פעולת ממשק לפרטים מלאים על סדרה כולל פירוט עונות ופרקים.

שדות נתוני שידור חי ו-VOD

שדה / תגיתרמהסוגערך לדוגמהתיאור
stream_idחובהInteger / String101מזהה מספרי ייחודי של הערוץ החי או של סרט ה-VOD.
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"סיומת קובץ הווידאו של הפרק ללא נקודה בהתחלה.

דפוסי כתובות שידור

סוגשדה / תגיתערך לדוגמה
טלוויזיה חיה{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 ומצב Active עבור מנויים פעילים.
  • שלח מערך JSON ריק [] במקום null כאשר הקטלוג ריק מתכנים.
  • ודא שכל category_id מפנה לקטגוריה קיימת ותקפה במערכת.
  • ציין את container_extension ללא נקודה בהתחלה (כגון mp4 או mkv).
  • תמוך בבקשות HTTP 206 Partial Content להרצה חלקה קדימה ואחורה בווידאו.