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 액션을 통해 실시간 방송, VOD 영화, 다중 에피소드 시리즈를 신속하고 독립적으로 분리하여 불러올 수 있습니다.

일관된 스트림 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"사용자의 구독 만료 시점을 지정하는 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}]주문형 비디오(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"}]VOD 영화 목록을 전체 또는 카테고리별로 조회하는 API 액션.
get_series필수Array of Series Objects[{"series_id":303,"name":"Example Series","category_id":"20"}]시청 가능한 전체 TV 시리즈 카탈로그 개요를 조회하는 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"스트림 유형: TV 채널은 '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 패턴

종류필드 / 태그예시 값
실시간 TV{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 및 Active 상태를 반환하세요.
  • 비어 있는 카탈로그 목록에 대해서는 null 대신 빈 JSON 배열 []을 반환하세요.
  • 모든 category_id가 실제로 존재하는 유효한 카테고리를 참조하는지 확인하세요.
  • container_extension 필드에는 앞에 점 없이 확장자만 기재하세요(예: mp4).
  • 동영상 탐색 및 이동을 원활하게 지원하기 위해 HTTP 206 Partial Content를 구현하세요.