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 क्रियाएं लाइव टीवी चैनलों, ऑन-डिमांड फ़िल्मों और टीवी श्रृंखलाओं को अलग-अलग कुशलतापूर्वक लोड करती हैं।

समान स्ट्रीम URL संरचना

स्ट्रीम 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"यूनिक्स टाइमस्टैम्प जो ग्राहक की सदस्यता समाप्ति तिथि निर्दिष्ट करता है।
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}]ऑन-डिमांड फ़िल्मों (VOD) की श्रेणियों की सूची प्राप्त करने के लिए API क्रिया।
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लाइव चैनल या VOD फ़िल्म का अद्वितीय संख्यात्मक पहचानकर्ता।
nameआवश्यकString"TRT 1 HD"एप्लिकेशन इंटरफ़ेस में चैनल या फ़िल्म का प्रदर्शित नाम।
stream_typeआवश्यकString ("live" | "movie")"live"स्ट्रीम प्रकार: टीवी चैनलों के लिए 'live' या VOD फ़िल्मों के लिए 'movie'।
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"बिना बिंदु के एपिसोड वीडियो फ़ाइल का एक्सटेंशन।

स्ट्रीम URL पैटर्न

प्रकारफ़ील्ड / टैगउदाहरण मान
लाइव टीवी{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
      }
    ]
  }
}

इंटरैक्टिव प्रारूप चेकर

Mayk IP TV संगतता की पुष्टि के लिए नीचे अपना M3U स्निपेट या Xtream JSON पेलोड चिपकाएं।

Xtream Codes API चेकलिस्ट

  • सक्रिय ग्राहकों के लिए user_info.auth = 1 और status = Active लौटाएं।
  • खाली सूचियों के लिए null के स्थान पर खाली JSON ऐरे [] भेजें।
  • जांचें कि प्रत्येक category_id एक वैध श्रेणी को संदर्भित करता है।
  • container_extension को बिना बिंदु के प्रदान करें (जैसे mp4 या mkv)।
  • वीडियो को सुचारू रूप से आगे-पीछे करने के लिए HTTP 206 का समर्थन करें।