Mayk IP TV

مرجع فنی

مشخصات فنی پروتکل Xtream Codes IPTV API

مشخصات فنی پروتکل Xtream Codes IPTV API. نقاط پایانی احراز هویت، دسته‌بندی‌ها، پخش زنده، فیلم، سریال و بررسی JSON.

معماری وب‌سرویس Xtream Codes API

این رابط ساختاریافته REST به نرم‌افزارهای پخش IPTV امکان می‌دهد عملیات ورود، شناسایی مشترک و بارگذاری کاتالوگ‌ها را با کارایی چشمگیر انجام دهند.

احراز هویت و مشخصات حساب کاربر

نرم‌افزار مشخصات ورود را به نشانی player_api.php می‌فرستد و وضعیت اعتبار، تاریخ انقضا و تنطیمات سرور را در قالب داده‌های ساختارمند تحویل می‌گیرد.

دستورات کاتالوگ و دسته‌بندی‌ها

درخواست‌های تفکیک‌شده به کاربر اجازه می‌دهد دسته‌های شبکه‌های زنده، فیلم‌های درخواستی و مجموعه‌های تلویزیونی را به سرعت واکشی نماید.

الگوی هماهنگ آدرس‌های پخش

پیوندهای پخش از چیدمان استانداردی همراه با پسوند مناسب پرونده‌های ویدیویی برای هر دسته محتوا تبعیت می‌کنند.

فیلدهای احراز هویت

فیلد / تگسطحنوعمقدار نمونهتوضیحات
user_info.authضروریInteger (1 = success)1وضعیت عددی تایید اعتبار: عدد ۱ نشانه ورود پیروزمندانه و ۰ نشانگر رد دسترسی است.
user_info.statusضروریString ("Active")"Active"وضعیت کنونی حساب کاربری همچون Active یا Expired یا Banned.
user_info.exp_dateضروریUnix Timestamp / null"1775000000"برچسب زمان یونیکس که موعد دقیق پایان اعتبار اشتراک کاربر را معین می‌کند.
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شناسه عددی منحصربه‌فرد برای شبکه زنده تلویزیونی یا فیلم سینمایی.
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"شاخص محتوای رده سنی بزرگسال: ۱ در صورت داشتن محدودیت، در غیر این صورت ۰.

داده‌های سریال‌ها و قسمت‌ها

فیلد / تگسطحنوعمقدار نمونهتوضیحات
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 را ارسال فرمایید.
  • در صورت خالی بودن فهرست‌ها، آرایه تهی [] را به جای null برگردانید.
  • بررسی کنید که مقادیر category_id به یک دسته معتبر ارجاع داشته باشند.
  • مقدار container_extension را بدون نقطه اولیه ثبت فرمایید (مثلاً mp4 یا mkv).
  • درخواست‌های پروتکل HTTP 206 Partial Content را جهت جلو و عقب بردن آسان ویدیوها پشتیبانی نمایید.