よくある質問と回答

完全な OTT / IPTV システムです：管理パネル（ダッシュボード）、視聴者のアプリ向け API サーバー、ライブチャンネル・映画・シリーズ・ラジオの配信、そして Web プレーヤー。システムは私たちが提供・保守し、リセラーはそれを使って顧客に視聴権（回線）を提供します。

• 代金の回収は行わず、決済ゲートウェイもありません。顧客への価格、入金方法、請求書はリセラーの責任です（CON-01 を参照）。
• リセラーの視聴者に連絡することはありません。パネルがメールを送るのはパネルアカウント宛てのみで、回線には送りません。
• 削除された顧客の個人データは保持せず、復元機能もありません（DATA-01 を参照）。

1. 管理者がカタログ（チャンネル、映画、シリーズ、ラジオ）を作成し、ブーケにまとめます。
2. 管理者がパッケージを作成します：ブーケ + 期間 + 接続数 + クレジットでの価格。
3. リセラーがクレジットを使ってパッケージを販売します → システムが回線を作成します。
4. 顧客が回線の情報をアプリに入力します。システムは回線を確認し（期限切れでないか、有効か、上限内か）、適切なサーバーから再生します。

リセラーはチャンネル、映画、シリーズ、ラジオ、ブーケ、パッケージの一覧を閲覧できます（グループに権限がある場合）が、コンテンツの追加・編集・削除はできません。コンテンツとパッケージは管理者が管理します。リセラーは、パッケージ（グループが許可していればブーケも — PKG-05）を選ぶことで、各顧客が何を視聴できるかを決めます。

サイドバーの Support をクリックすると、別のサポートサイトが開きます。パネル自体にチケットシステムはありません。依頼を送るときは、回線のユーザー名（パスワードは不可）、発生した日時、アプリ / デバイス、すでに試した場合はこのページの質問コードを添えてください。

パネル、Web プレーヤー、このヘルプページには、27言語の言語切り替えがあります。英語とベトナム語が基準の翻訳で、それ以外の言語では、新しく追加された画面がしばらく英語のままの場合があります。パネルが送信するメールは現在、英語のみです。

インストールパッケージ、その SHA-256 チェックサム、完全なインストールガイド（英語）は https://download.xtream-ui.pro にあります。

• 必要なもの：Ubuntu 22.04 または 24.04（仮想マシンまたはベアメタル）、root または sudo 権限、できれば新規のサーバー。
• インストール：お使いの CPU 用パッケージをサーバー上で直接ダウンロードし、sha256sum で検証して展開し、sudo ./install.sh を実行します。
• 稼働中サーバーのアップグレード：sudo ./upgrade.sh --tag <version>。

TLS 対応ドメイン、エッジノード、全オプションはガイドで説明しています。

仕様です：回線はパネルアカウントではありません。顧客は、回線の情報を IPTV アプリ、セットトップボックス、Web プレーヤーで使うだけです。逆に、リセラーアカウントでチャンネルを視聴することもできません。

メニューと操作は、管理者があなたのアカウントに割り当てたグループによって決まります。グループに権限のないページはサイドバーに表示されず、開くこともできません。権限の追加は管理者に依頼してください。

アカウント領域（プロフィール → パスワード変更）です。パネルのパスワードはハッシュ化して保存されており、管理者でも読み出せません。忘れた場合は、上位のアカウント（親リセラーまたは管理者）に新しいパスワードの設定を依頼してください。

パネルは、IP アドレスが変わるとセッションを終了するよう設定できます。盗まれたセッションを再利用されないためです。もう一度ログインしてください。これは管理者の設定です。

パネルはログインの失敗回数を制限します（管理者が設定）。上限を超えると、しばらく待ってから再試行する必要があります。

デモアカウントはインターフェースを見せるだけです：パスワードの変更、プロフィールの編集、アクティベーションコードの作成、取り消せない操作はできません。

上位のアカウントがオフにしました：パネルにログインできず、API キーも拒否されます。すでに販売した回線は削除されません。上位のアカウントに連絡してください。

Logs → Reseller Logs（グループにログの閲覧権限がある場合）：回線やデバイスの作成・編集・更新・有効化 / 無効化・削除、サブリセラーの作成、クレジットの移動のすべてが、消費したクレジットとともに記録されます。見られるのは自分と配下のアカウントの記録だけで、ログは削除できません（管理者のみ）。残高の突き合わせは、引き続きクレジット台帳（CRD）で行います。

パネルのプリペイド単位です。販売のたび（回線作成、更新、アクティベーションコード作成、サブリセラー作成）に、パッケージ価格またはグループの手数料に応じてクレジットが消費されます。クレジットは通貨ではなく、パネルは換算もしません。1クレジットの価値は、あなたと上位のアカウントの間で取り決めます。

クレジットは上から下へ流れます：管理者がリセラーにクレジットを付与し、リセラーがサブリセラーに移動します。上位のアカウントへの支払いはパネルの外で行います。

回線が配下のサブリセラーに割り当てられていても、常に操作を実行したアカウントのクレジットです。

Credits ページです：1件の動きにつき1行で、日付、金額、その後の残高、理由、実行者が表示されます。これが台帳であり、残高の正式な根拠です。

操作全体が拒否されます：回線は作成されず、何も課金されません。残高がマイナスになることはありません。

いいえ。販売リクエストにはすべてリクエスト ID（request_id）が付いており、同じ ID を再送すると前回の結果が返されます。回線の作成とクレジットの課金は、必ず一緒に成功するか、一緒に取り消されます。

いいえ。回線を削除しても、期間が残っていても返金はありません。唯一の例外：リセラーが作成した未使用のアクティベーションコードを削除した場合は返金されます（CODE-08）。

はい：サブリセラーの編集フォームで、クレジット移動欄にマイナスの数値を入力します。どの残高も 0 を下回ることはありません。

回線フォームのパッケージ選択に、あなた自身の価格が表示されます。API では、pricing アクションが残高、各パッケージの価格、購入可能な数を返します。

ブーケはコンテンツ（チャンネル、映画、シリーズ）の一覧です。パッケージは販売する商品で、1つ以上のブーケ、期間、接続数、出力フォーマット、ロック、クレジットでの価格（正規価格とトライアル価格）から成ります。

パッケージは、管理者がそのために選んだグループだけが販売できます。あなたのグループ向けでないパッケージは、選択欄に表示されず、API で送信しても拒否されます。

管理者は、リセラーごと・パッケージごとに専用価格を設定できます（0 = 無料）。専用価格は、正規回線の作成、更新、正規のアクティベーションコードに適用され、トライアルには適用されません。

いいえ。ブーケは販売時に回線へコピーされるため、その後パッケージを編集しても販売済みの回線には影響しません。回線は、次回の更新 / パッケージ変更時に新しいブーケを受け取ります。（ブーケの中身が変わると、そのブーケを持つすべての回線に即座に反映されます。ブーケを削除すると、すべての回線とパッケージからその ID が取り除かれます。ブーケ全体の並び順を変更しても、「販売済みの回線とパッケージに適用」にチェックを入れたときだけ、販売済み回線に保存された順序が変わります。回線が持つブーケの組み合わせは変わりません。）

グループで Allow Bouquet Selection がオンの場合のみ可能です：パッケージのブーケの一部にチェックを入れます。何もチェックしなければパッケージ全体になり、パッケージ外のブーケは除外されます。価格は変わりません。

有効期限（今日 + パッケージの期間）、接続数、出力フォーマット、restreamer、デバイスロック、強制国、強制サーバー、ISP ロック、ブーケです。リセラーがこれらの項目に入力した値は無視されます。ただし、ブーケ（PKG-05）と、グループで Allow Line Restrictions がオンの場合の ISP ロックは例外です。

その種類のセットトップボックス専用に販売できるパッケージで、通常の回線や別の種類のデバイス向けには販売できません。逆に、Add MAG / Add Enigma フォームで使うには、パッケージがそのデバイスの種類を許可している必要があります。

グループが販売できるパッケージを選び、十分なクレジットが必要です。ユーザー名 / パスワードは、（グループが許可していれば）自分で入力するか、空のままにして自動生成させます。管理者は回線作成時に片方（または両方）を空にすることもできます：システムが10文字を生成し、保存直後に表示します。ただし編集フォームではユーザー名が必須です。

グループで Allow Username Change / Allow Password Change がオフになっているため、新しい回線には生成された値が使われます。自分で入力できる場合、最小文字数はグループで設定されます（初期値は8文字）。

回線の編集フォームと、Lines 一覧の Generate play link ダイアログです。IPTV アプリと再生リンクに必要なため、回線のパスワードは読み取れる形で保持されています。生成されたパスワードは、保存直後に表示されます。

パネルの旧バージョンで作成された一部の回線は、ハッシュ化されたパスワードしか持っていません。そのような回線はログインできず、パネルにもパスワードは表示されません。回線の編集フォームで新しいパスワードを設定し、顧客に送ってください。

有効化 / 無効化、リセラーメモ、連絡先、カテゴリテンプレート、所有者（自分の系統内）。グループが許可していればユーザー名とパスワード。グループで Allow Line Restrictions がオンなら制限（IP、ユーザーエージェント、ISP ロック）。グループが許可していればパッケージ内での新しいブーケ選択。パッケージ、有効期限、接続数、トライアルフラグ、出力フォーマット、デバイスロック、国は直接編集できず、更新 / パッケージ変更でのみ変わります。

方法は2つ、ルールは1つです：

• 一覧の Renew (charged) ボタン：回線の現在のパッケージを使います。
• 編集フォームの Extend with package 欄：販売可能な任意のパッケージを選びます（これがパッケージ変更の方法でもあります）。

回線を編集して同じ保存で更新も選んだ場合、両方が1つのトランザクションになります：更新が拒否されると（クレジット不足、パッケージが販売不可）、編集も保存されず、クレジットも課金されません。修正してからもう一度保存してください。

• 回線が期限切れでなく、新しいパッケージが旧パッケージと互換である → 現在の有効期限に時間が加算されます。
• 回線が期限切れ、または2つのパッケージに互換性がない → 今日から計算され、残り時間は引き継がれません。

「互換」は、新しいパッケージで互換性チェックのオプションがオンの場合にのみ確認されます：両方のパッケージで、ブーケ、出力フォーマット、接続数、restreamer フラグ、デバイスロックが同じである必要があります。オプションがオフなら常に互換とみなされます。新しいパッケージはこのオプションが初期でオンです（管理者がオフにできます）。既存のパッケージは現在の設定を保ちます。MAG / Enigma の回線は、その種類のボックスを許可するパッケージでのみ更新または変更できます。

パッケージ変更 = 新しいパッケージの正規期間を1回購入することです：新しいパッケージの満額（専用価格があればその価格）が課金され、未使用分の払い戻しはありません。回線は新しいパッケージのすべての属性を引き継ぎます。

無効化：顧客はログインも視聴もできず、実行中のセッションは約1分以内に閉じられます。契約期間は進み続け、いつでも再び有効にできます。削除：恒久的で、復元も返金もありません（DATA-01）。顧客が一時停止する場合は、削除せず無効化してください。

回線が更新されるまで顧客は拒否されます（期限切れかつ Banned の回線には、期限が先に確認されるため「期限切れ」の映像が表示されます）。実行中のセッションは約1分以内に閉じられます。回線は自動では削除されません：更新すれば、同じユーザー名 / パスワードで再び使えます。

はい：所有者として配下のアカウントを選びます。所有者は自分の一覧にその回線が表示されます。クレジットは、保存を押した人に引き続き課金されます。

自分の回線と、配下のすべてのアカウントの回線です。自分の系統外の回線は存在しないものとして扱われます（「見つかりません」と返ります）。

顧客が誰かを覚えておくためのものです（メール、電話番号、注文番号）。契約者には表示されません。回線を削除すると、完全に消去されます。

グループに権限がある場合：Logs → Line Activity で各回線の視聴履歴、Logs → Live Connections で系統内の回線の開いている接続すべて（どの回線、どのチャンネル、どのアドレスから）が表示され、接続を閉じるボタンもあります。Live Connections は、管理者があなたのグループに対して顧客の接続履歴の閲覧オプション（グループフォームの client connection logs ボックス）をオンにした場合のみ開けます。系統外の回線の接続は見られません。

アクティベーションコードに属する回線は、絞り込まない限り、初期状態では一覧に表示されません（CODE-02）。

はい。回線フォームの Expires on 欄は、パネルのタイムゾーンでの日付と時刻なので、回線を特定の時刻に期限切れにできます。この欄に触れずにフォームを開いて保存すると、期限は秒単位で保たれます：メモやブーケを編集しても、時間単位のトライアル回線に余分な時間は付きません。読み取れない値は、その欄でエラーとして表示され、「無期限」になることはありません。一括編集ページは引き続き日付を受け付け、その日の終わりとして扱います。

次の条件がすべて満たされるときです：管理者がリセラー向けのトライアルをオフにしていない、パッケージにトライアル期間がある、グループの Allowed Trials が 0 より大きい、クレジットがグループの Minimum Trial Credits 以上である、集計期間内に作成したトライアル回線の数が上限に達していない。

グループの設定に従います：day = 直近24時間、month = 直近30日。例：上限が 5 / day なら、24時間のどの区間でもトライアル回線は最大5本です。古いトライアルは、期間から外れると枠が空きます。

パッケージのトライアル価格どおりです（通常は 0）。リセラーの専用価格はトライアルには適用されません。

TRI-01 の条件のどれかが満たされていません。理由はフォームのチェックボックスの横に表示されます。

回線をパッケージで更新します：回線に正規の期間が付与され、トライアルではなくなります。ユーザー名とパスワードは同じままで、顧客が設定し直す必要はありません。

いいえ。トライアルは回線の作成時に一度だけ付与されます。既存の回線は正規期間での更新のみ可能です（TRI-05）。顧客にもう一度試してもらうには、新しいトライアル回線を作成してください（トライアルの上限にカウントされます）。

Lines → Generate play link：フォーマットを選ぶと、回線のユーザー名とパスワードでリンクが作られます。API では、get_line が完成したリンクを返します：m3u、m3u_hls、xmltv、player_api、web_player。

Xtream Codes API に対応したアプリならどれでも使えます（IPTV Smarters、TiviMate、XCIPTV、GSE…）：サーバーアドレス + ユーザー名 + パスワードを入力します。プレイリストしか受け付けないアプリには M3U リンクを使います。MAG ボックスはポータル、Enigma2 ボックスはプレイリスト / プラグインを使います。デバイスがなければ、ブラウザのWeb プレーヤーを使います。

MPEG-TS：チャンネルの切り替えが速く、IPTV アプリやセットトップボックスに向いています。HLS：ブラウザ、Apple デバイス、不安定なネットワークで安定して動きます。回線はパッケージが許可したフォーマットしか使えず、許可されていないフォーマットのリンクは拒否されます。

m3u_plus（ロゴ、グループ、EPG ID 付き — 推奨の初期値）、通常の m3u、Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive 向けの種類、そしてシンプルな一覧形式です。Generate play link ダイアログで選びます。

Xtream アプリは自動で取得します。M3U アプリでは、回線の XMLTV リンクを使います（m3u_plus プレイリストには EPG アドレスがすでに含まれています）。

はい、管理者がアーカイブを有効にしたチャンネルで利用できます。アプリでは、該当チャンネルにキャッチアップのアイコンが表示されます。

API サーバーの /player/ です（web_player リンク）。回線のユーザー名 / パスワード、またはアクティベーションコードでログインします。

いいえ。パスワードはリンクの一部で、アプリにも保存されているため、変更後は顧客が再入力するか、新しいリンクを受け取る必要があります。許可なく回線を使っている人を締め出す方法でもあります。

はい：API キーのページで Your own play address を設定します（または set_play_base API アクションを使います）。ドメインの DNS をパネルの API サーバーに向ける必要があり、さらに運営者側でも設定が必要です。使用する前に管理者に伝えてください。このアドレスは、API があなたのシステムに返すリンクに適用されます。

技術的には1つの回線を共有することになるため、接続数（SEC-01）も共有し、second IP ルール（SEC-03）に引っかかる可能性があります。顧客ごとに専用の回線を用意してください。

Devices → Add MAG / Add Enigma：MAC を入力し、パッケージを選びます。システムが新しい回線を販売し、同時にデバイスを紐づけます。デバイスは MAC でログインするため、ユーザー名 / パスワードを入力する必要はありません。クレジットは通常の回線とまったく同じように課金されます。

デバイスフォームで、パッケージの代わりに顧客の既存の回線を選びます：デバイスはその回線とペアリングされ、無料です。顧客はこれまでどおりアプリで回線を使い、ボックスは回線のパッケージ、有効期限、ブーケ、ステータスに従います。

接続数の上限を共有します：アプリとボックスは1人の契約者として扱われます。

その回線を更新します（リンクはデバイスフォームにあります）。ペアリングしたデバイスの場合は、顧客の回線を更新すれば、ボックスは自動で追従します。

デバイスの MAC を編集します。回線でデバイスロックがオンの場合は、新しいボックスが登録できるよう、記録されたシリアル番号 / デバイス ID を消去してください。

はい。デバイスを削除すると、その回線（接続履歴と保留中のイベントを含む）も削除されます。料金を支払った回線を残すには、Convert to line ボタンを使います：デバイスは削除され、回線は通常の回線になります。顧客の回線を削除した場合、ペアリングされたデバイスは専用の回線を持って独立して残ります。

自分の MAG ボックスなら可能です：テレビへのメッセージ送信、チャンネル再生、ポータルの再読み込み、再起動、回線の接続を閉じる（グループに顧客の接続ログを閲覧する権限が必要）、記録された ISP のリセット、STB ロックのリセット。Enigma ボックスの X-Plugin コマンドとスクリーンショット、デバイスの BAN、デバイスの別回線への移動は管理者のみです。リセラーのデバイスを有効化 / 無効化すると、その回線も有効化 / 無効化されます。リセラーはデバイスの Banned を解除できません。

アクセスをコードとして販売する方法です（スクラッチカードや、メッセージで送るコード）：顧客がアプリまたは Web プレーヤーにコードを入力すると、ユーザー名 / パスワードなしで視聴できます。期間は顧客が初めてコードを有効化したときにはじめて開始されます。

Active Codes → New：パッケージ、数量（1バッチあたり 1～500）、コードの長さ（6～24）、数字のみのオプション（テレビのリモコンで入力しやすい）、トライアルのオプションを選びます。クレジットは作成時に課金されます = パッケージ価格 × コードの数。各コードには専用の回線が付き、有効化されるまでロックされています。

大文字の英字と数字で、紛らわしいもの（0、O、1、I）は除かれます。または数字のみです。顧客が小文字で入力しても受け付けられます。

1台です。コードは最初に有効化したデバイスに紐づき、別のデバイスが同じコードを入力すると拒否されます。そのデバイスは何度でもコードを入力でき、回線のログイン情報は変わりません。

そのコードで Reset device を実行します。すると新しいデバイスで有効化できます。期間は加算されません。

異なる誤ったコードを続けて何度も入力すると、IP アドレスがしばらくブロックされます（SEC-08）。

Active Codes ページでコードにチェックを入れ、Extend (days) アクションを選んで日数を入力します。日数が加算されるのは有効化済みのコードだけです（未使用のコードは期間がまだ始まっていません）。有効なコードは現在の有効期限から、期限切れのコードは現時点から延長されます。この操作ではクレジットは課金されないため、使えるのは管理者のみです。リセラーは、他のラインと同じように、パッケージとその価格でコードのラインを更新します（Lines → Renew、または Reseller API の renew_line）。誤った課金はサポートがクレジット調整で修正し、無料の延長で対応することはありません。Admin API：extend_active_code。

リセラーが作成した未使用のコード：全額が返金され、クレジット台帳に1行記録されます。有効化済みのコード：返金はありません。

Batches ページに、バッチごとの合計 / 準備完了 / 有効化済み / 無効の件数が表示され、TXT ファイル（1行に1コード）をエクスポートできます。一括操作：有効化、無効化、デバイスのリセット、削除。

はい。そのパッケージで販売されたすべての回線と同様です：接続数、出力フォーマット、ブーケ、デバイスロック、restreamer、そしてパッケージの強制国（SEC-07）にも従います。許可リスト外の国でコードを有効化した顧客は、有効化はできても、再生時に拒否されます。

1つの回線で同時に視聴しているデバイスの数です。0 = 無制限。同じデバイスから、すでに視聴中のチャンネルをもう一度開いても、別の接続とは数えられません。

初期設定では、新しい接続が入り、最も古い接続が閉じられます（同じデバイスからの接続を優先し、次に同じ IP からのものを優先します）。閉じられたプレーヤーは約30秒以内に停止します。管理者は、古い接続を閉じる代わりに新しい接続を拒否する設定に切り替えられます。

管理者がオンにしている場合：回線が1つの IP から視聴されている間、別の IP からのライブ接続は拒否されます。このルールは接続数の少ない回線に限定できます（例えば接続数1の回線。接続数が無制限の回線は、しきい値が 0 のときだけ対象になります）。Match The Address By Network がオンの場合、同じ /24 ネットワーク（IPv6 では /64）のアドレスは1人の視聴者として扱われます。アカウント共有への対策です。

グループで Allow Line Restrictions がオンの場合：Allowed IPs 欄（IP、CIDR 範囲、またはドメイン名を1行に1つ。ドメインは接続時に名前解決されるため、動的 IP でも動作します）と Allowed User-Agents があります。空 = すべて許可。注意：これらの制限は再生時にブロックします。アプリ自体はログインでき、チャンネル一覧も表示されます。

回線は最初の接続時のインターネットプロバイダを記憶し、別のプロバイダからの利用を拒否します。顧客がプロバイダを変えたときは、ISP ロックをオフにしてからもう一度オンにすると、新しいプロバイダが記録されます。MAG ボックスには適用されません。

回線を、最初にログインしたセットトップボックス（シリアル番号、デバイス ID）に紐づけ、別のボックスは拒否します。パッケージで決まります。

回線は強制国からのみ接続できます（ALL = どこからでも）。空の場合は、パネル全体の許可国リストが適用されます。海外旅行中や VPN を使っている顧客は、この理由で拒否されることがあります。

• 自動：1つの IP から多数の異なるユーザー名 / アクティベーションコードでログインに短時間で失敗した場合、またはリクエストが殺到した場合。自動ブロックは、管理者が設定した時間（初期値は60分）が過ぎると自動で解除されます。
• 手動：管理者が IP / IP 範囲をブロックした場合。期限はありません。

IP がブロックされている間は、その IP からどの回線も接続できません。同じユーザー名を繰り返し打ち間違えても、ブロックにはなりません。

管理者は User-Agent（アプリ）、インターネットプロバイダ（ISP）、ASN（例：ホスティング / VPN の範囲）でブロックできます。管理者が「bypass UA」をオンにした回線は、アプリのブロックリストの対象外になります。

ストリームを取り込んで再配信するパートナー向けの回線です。接続数の上限、second IP ルール、長時間セッションの自動終了、ASN ブロックの対象外です。パッケージ / 管理者が決めるもので、一般の視聴者向けではありません。

管理者は連続セッションの最大時間を設定できます。それを超えるとセッションは閉じられ、顧客は再生を押して続けます。信号が約90秒途切れたセッションも、閉じられたものとして扱われます。

• Theft Detection ページ（グループに権限がある場合）：1時間 / 24時間 / 7日間に視聴した異なる映画 / エピソードの数で回線を順位付けし、異なる IP の数も表示します。異常に多い回線は疑わしいです。
• 回線のアクティビティページ：使用中の IP とデバイスが表示されます。
• 対処：回線のパスワードを変更する（PLAY-08）、IP 制限 / ISP ロックをオンにする、または回線を無効化する。

グループで Can Create Sub-Resellers がオンで、Groups for sub-resellers に少なくとも1つのグループがある場合に可能です。作成のたびに、グループで設定された作成手数料（クレジット）が課金されます。リセラーの階層は最大5段です。

管理者が許可した一覧からグループを選びます。そのグループが、サブリセラーの権限、販売可能なパッケージ、トライアルの上限を決めます。

メール、名前、パスワード、ステータス、グループ（一覧から）、メモ、クレジットの移動 / 回収、そしてその配下のすべての回線です。役割や所有者は変更できません。

見えません：どのアカウントも自分より下にあるものしか見えず、上位の階層や他の系統は見えません。

グループで Can Delete Users がオンである必要があります。残りのクレジット、回線、配下のアカウントは、削除を実行したアカウントに移ります。顧客の回線は引き続き動作します。削除されたアカウントの個人データ（ユーザー名、メール、名前、パスワード、API キー、メモ）は消去され、そのユーザー名とメールは再利用できます。

管理者がウェルカムメールを有効にしている場合：新しいアカウントにログイン名とログインリンクが届きます。メールにパスワードは絶対に含まれません。パスワードはあなたが自分で伝えます。

顧客がアプリで見るカテゴリ（ライブ、映画、シリーズ、ラジオ）の並び替え、名前変更、非表示を、パネル自体のカテゴリには触れずに、回線単位で行うためのものです。

そのカテゴリのコンテンツも、テンプレートを使う回線のアプリとプレイリストから非表示になります。

はい、テンプレートが割り当てられているすべての回線に即座に反映されます。テンプレートを削除すると、その回線は初期のレイアウトに戻ります。

閲覧：自分のもの、配下のアカウントのもの、システムテンプレート、上位の階層が共有しているテンプレート。編集：自分のものと配下のものだけ。システムテンプレートを調整するには、複製して、そのコピーを編集してください。

カスタムのカテゴリ順は、M3U プレイリストの映画 / シリーズ部分には適用されません（名前と非表示は適用されます）。Xtream API を使うアプリは、すべてを受け取ります。

自分のシステム（Web ショップ、課金、ボット）から、ダッシュボードを開かずに回線やサブリセラーを販売・管理するためのものです。アドレス：{API}/reseller/v1、X-API-Key ヘッダーで認証します。詳しいドキュメントは API サーバーの /docs/ にあります。

API Key ページです。キーは作成時に一度だけ表示されるので、すぐにコピーしてください。なくした場合は新しいキーを作成します（古いキーは使えなくなります）。

おすすめしません。システムごとに追加のキーを作成してください：名前を付け、使用できる IP / CIDR を制限し、必要に応じて読み取り専用（一覧と閲覧のみ）にし、ほかのキーに影響を与えずにそのキーだけを失効させられます。

ダッシュボードのすべてのルール（グループ、専用価格、トライアルの上限、系統の範囲）は、API でもまったく同じように適用されます。

いいえ。同じ取引に同じ request_id を送る限り、システムは前回の結果を返します。更新の request_id はその回線に紐づきます：別の回線で再利用すると競合エラー（HTTP 409）が返り、もう一方の回線は変更されません。取引ごとに新しい request_id を生成してください。

API Key ページに最近の API 呼び出しの表（30日分）があります：アクション、結果、エラーコード、呼び出し元アドレス、コネクタ名。パラメータは記録されません。

何かが起きたときにパネルがあなたのシステムに知らせる仕組みで、何度も問い合わせる必要がありません。イベント：line.created、line.renewed、line.enabled、line.disabled、line.deleted、line.expiring（3日前）、line.expired、credits.low（設定したしきい値を下回ったとき）。受信アドレスは https で、インターネットから到達できる必要があります。

すべての通知には署名 X-Xtream-Signature: sha256=HMAC(secret, timestamp.body) が付きます。シークレットはエンドポイントの作成時に一度だけ表示されます。Webhook にパスワードが含まれることはありません。

各通知は3回試行されます。20回連続で配信に失敗したエンドポイントはオフになります。自分側を修正し、Send test を使い、オフになっていた場合はエンドポイントを作り直してください。

はい。ただし、回線の所有者（あなたと、系統内であなたより上位のアカウント）にのみ返します。回線のパスワードをログに保存したり、安全でない経路で送ったりしないでください。

はい、package_id を一緒に送った場合（旧名の package も受け付けます）：編集に加えて、そのパッケージの正規期間を change_package とまったく同じように販売します — 同じ価格、同じ request_id で、応答には credits_charged が含まれます。編集と更新は1つのトランザクションで、拒否された場合（クレジット不足、無効なパッケージ、trial を同時に送った場合）は何も変更されません。パッケージを指定しない edit_line は、ユーザー名、パスワード、連絡先、メモだけを編集し、パッケージや有効期限には触れません。

そのままでは動きません。この API は見慣れたアクション名を保っていますが、新しいインターフェースです：アドレスは /reseller/v1、API キーはこのパネルで作成したもの、書き込み操作は POST で送信、エラーは error フィールド付きの HTTP ステータスで返され、回線作成の結果は data.line に入ります。/docs/ のドキュメントか、用意されたコネクタ（CON-02）を使ってください。

自分のシステムと決済ゲートウェイを使います。パネルは決済を処理しません。コネクタがあなたのショップシステムとパネルをつなぎます：顧客があなたの側で支払う → コネクタが Reseller API を呼び出して回線を作成 / 更新します。

WHMCS、Blesta、WISECP、HostBill、ClientExec、FOSSBilling、Paymenter、WordPress（WooCommerce / Easy Digital Downloads）、Odoo、PrestaShop、OpenCart、Magento、Dolibarr、ERPNext、そして Shopify、Upmind、Invoice Ninja 向けの「webhook bridge」です。

パネル内：サイドバーの Resources → All Connectors で、各コネクタの接続情報、インストール手順、Download ボタン、検証用のファイルの SHA-256 を確認できます。

同じコネクタをインストール手順とチェックサム付きで https://plugins.xtream-ui.pro に公開しています。ソースコードは https://github.com/xtreamui-pro/plugins です。

コネクタごとに異なり、各コネクタのページに記載されています：実際のプラットフォーム上で動作確認したもの（例：WordPress + WooCommerce、Odoo、FOSSBilling、Paymenter）もあれば、コア部分のみ試したものもあります。「how it was tested」の行を読み、本番で販売する前にテスト環境で試してください。

コネクタはあなたの API キーで Reseller API を呼び出すだけです。あなたにできることだけができ、それ以上はできません。ソースコードは公開されており、読んで確認できます。コネクタごとに、IP 制限付きの専用キーを使ってください（API-03）。

回線（作成、更新、パッケージ変更、停止、削除）と、クレジット付きのサブリセラーアカウントです。

Reseller API（API-01）と Webhook を使って自分で連携するか、サポート窓口からリクエストを送ってください。

いいえ。削除したものは消えます：回線の情報（ユーザー名、パスワード、連絡先、メモ）、接続履歴（IP、デバイス、視聴内容）、回線に紐づいたセットトップボックス、そのアクティベーションコード。ゴミ箱も、復元機能や API もありません。顧客が戻ってきたら、新しい回線を作成してください。

運営者向けの匿名の統計記録のみです（新規顧客か再訪顧客か、どのパッケージが人気か）。顧客について読み取れる情報は一切含まれず、リセラー、コネクタ、API からもアクセスできません。

いいえ。データベースのバックアップは、障害後にシステムを再構築するためだけに存在し、運営者が保管しています。削除の取り消しには使いません。古いバックアップは順次ローテーションで消えるため、削除したデータもそこから消えます。

回線のパスワードはアプリに入力する必要があり、プレイリストのリンクにも含まれるため、パネルは回線の所有者向けに読み取れる形で保持します。パネルアカウントのパスワードは、ハッシュ化してのみ保存されます。

あなた自身、系統内であなたより上位のアカウント、そして管理者です。ほかのリセラーや、あなたより下位の階層には見えません。

送りません。回線の顧客はリセラーのものです。顧客への連絡は、ご自身のシステムで行ってください。

2つの方法があります：期限が近い回線の日次サマリーメール（管理者が有効にしている場合。初期値は3日前）と、あなたのシステム向けの line.expiring / line.expired Webhook です。

たいていは再生ロックのどれかです（FIX-01 の 5～9 行目）：ログインとチャンネル一覧では IP / アプリを確認せず、再生時にだけ確認します。1つのチャンネルだけがすべての回線で失敗する場合 → ソースのチャンネルに問題があります。管理者にチャンネル名と時刻を伝えてください。

回線のブーケ（PKG-04、PKG-05）と、割り当てられたカテゴリテンプレート（CAT-02）を確認してください。変更後は、顧客にアプリで一覧を再読み込みしてもらいます。管理者が追加したばかりのチャンネルは約30秒後に表示されます。チャンネルがブーケに入っているのにどの回線にも見えない場合は、管理者がそのチャンネルを停止している可能性があります。

順番に試してください：別のチャンネル（1つのチャンネルだけか、すべてか？）→ 別のネットワーク → 別のフォーマット（MPEG-TS の代わりに HLS）→ 別のアプリ。どのネットワークでもすべてのチャンネルで失敗する → サポートにユーザー名、時刻、チャンネルを伝えてください。

M3U アプリでは XMLTV リンクの追加が必要です（PLAY-05）。ソース側に EPG がないチャンネルには、番組表が表示されません。

順に確認：パッケージが未選択 · パッケージがあなたのグループ向けではない（PKG-02）· クレジット不足（CRD-05）· ユーザー名が使用済み、または最小文字数に満たない（LINE-02）· トライアルの上限を使い切った（TRI-01）。

429：回線が同時に多くのプレイリスト / EPG ファイルをダウンロードしています。しばらく待って再試行してください。404 ページ：理由を第三者に知られないよう、システムはすべての拒否（情報の誤り、期限切れ、ロック、上限超過）に 404 を返します。FIX-01 で確認してください。

あなたのグループにそのページの権限がありません（ACC-02）。Live Connections は、さらに管理者がグループに対して顧客の接続を閲覧するオプションをオンにしている必要があります（LINE-15）。

メールが送られるのは、管理者がメールサーバーを設定し、その種類のメッセージを有効にしている場合のみです。アカウントには実在するメールアドレスが必要です。迷惑メールフォルダーも確認してください。