Mayk IP TV

المرجع التقني

مواصفات تنسيق Xtream Codes IPTV API

المواصفات الفنية لواجهة Xtream Codes IPTV API. نقاط المصادقة، الفئات، البث الحي، VOD، المسلسلات وفحص JSON التفاعلي.

بنية واجهة Xtream Codes API

توفر واجهة Xtream Codes واجهة REST منظمة تتيح لمشغلات IPTV إدارة تسجيل الدخول وجلب كتالوجات المحتوى بسلاسة وأمان.

المصادقة وملف تعريف المشترك

يرسل التطبيق بيانات الاعتماد إلى player_api.php ويتلقى حالة الاشتراك وتاريخ الانتهاء وإعدادات الخادم الفنية.

إجراءات الفهرس والتصنيفات

تسمح طلبات API المستقلة بتنزيل قنوات البث الحي وأفلام المشاهدة حسب الطلب والمسلسلات بكفاءة وسرعة.

البنية الموحدة لروابط البث

تتبع عناوين 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}]إجراء 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 يعرض أفلام VOD بشكل شامل أو مصفى حسب الفئة.
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"امتداد ملف الفيديو الخاص بالحلقة بدون نقطة بداية.

أنماط عناوين البث

النوعالحقل / العلامةقيمة تجريبية
بث مباشر{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 أو حمولة Xtream JSON أدناه للتحقق من التوافق مع مشغل Mayk IP TV.

قائمة التحقق لواجهة Xtream Codes API

  • قم بإرجاع user_info.auth = 1 وحالة Active للمشتركين النشطين.
  • أرسل مصفوفة فارغة [] بدلاً من null في حالة الفهارس الفارغة.
  • تحقق من أن كل category_id يشير إلى فئة تصنيف موجودة وصالحة.
  • قدم container_extension دون نقطة في بدايته (مثل mp4 أو mkv).
  • ادعم طلبات HTTP 206 Partial Content للتمرير السلس داخل الفيديو.