خانه
Xtream UIPro

مرکز راهنما

پرسش و پاسخ

کردیت، پکیج، لاین، لینک پخش و دستگاه‌ها چگونه کار می‌کنند — و وقتی چیزی پخش نمی‌شود چه چیزی را باید بررسی کرد.

139 از 139 پرسش

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

نحوه استفاده از این صفحه

هر پرسش یک کد ثابت دارد (مثلاًLINE-07). هنگام تماس با پشتیبانی آن را ذکر کنید، یا پیوند پرسش را کپی کنید.

نام منوها، دکمه‌ها و فیلدها همان‌طور که در پنل نمایش داده می‌شوند نوشته شده‌اند.کاربر(user) حسابی است که وارد پنل می‌شود (ادمین، ریسلر)؛لاین(line) اشتراک IPTV یک بیننده است. این دو هرگز با هم اشتباه گرفته نمی‌شوند.

  • بیننده ریسلر می‌تواند این پاسخ را همان‌طور که هست برای بیننده بفرستد
  • ادمین برای اپراتور پنل

نمای کلی سرویس و مسئولیت هر طرف

GEN
GEN-01 این سرویس چه چیزی ارائه می‌دهد؟

یک سیستم کامل OTT / IPTV: پنل مدیریت (داشبورد)، سرور API برای برنامه‌های بینندگان، پخش کانال‌های زنده، فیلم، سریال و رادیو، و یک وب پلیر. ما سیستم را فراهم و نگهداری می‌کنیم؛ ریسلرها از آن برای دادن حق تماشا (لاین) به مشتریان خود استفاده می‌کنند.

#GEN-01
GEN-02 این سرویس چه کارهایی را انجام نمی‌دهد؟
  • برای شما پول جمع‌آوری نمی‌کند و درگاه پرداخت ندارد. قیمت برای مشتریان شما، نحوه دریافت پول و صدور فاکتور به عهده ریسلر است (بهCON-01نگاه کنید).
  • با بینندگان ریسلر تماس نمی‌گیرد. پنل فقط به حساب‌های پنل ایمیل می‌فرستد، هرگز به یک لاین.
  • داده‌های شخصی مشتری حذف‌شده را نگه نمی‌دارد و قابلیت بازیابی ندارد (بهDATA-01نگاه کنید).
#GEN-02
GEN-03 چه کسی در سیستم چه نقشی دارد؟
Roleچه کسی استاز کجا وارد می‌شود
Adminاپراتور پنلداشبورد
Resellerلاین می‌فروشد؛ از ادمین کردیت می‌گیردداشبورد، Reseller API
Sub-resellerریسلری که زیر یک ریسلر دیگر ساخته شدهداشبورد، Reseller API
Lineیک مشترک — بیننده نهاییبرنامه IPTV، ست‌تاپ‌باکس، وب پلیر.هرگزداشبورد
#GEN-03
GEN-04 یک کانال از چه مراحلی تا بیننده می‌رسد؟
  1. ادمین کاتالوگ (کانال‌ها، فیلم‌ها، سریال‌ها، رادیو) را می‌سازد و آن را دربوکه‌ها(bouquet) گروه‌بندی می‌کند.
  2. ادمین یکپکیجمی‌سازد: بوکه‌ها + مدت + تعداد اتصال + قیمت به کردیت.
  3. ریسلر برای فروش پکیج کردیت خرج می‌کند → سیستم یکلاینمی‌سازد.
  4. مشتری مشخصات لاین را در یک برنامه وارد می‌کند؛ سیستم لاین را بررسی می‌کند (منقضی نشده، فعال، در محدوده مجاز) و از یک سرور مناسب پخش می‌کند.
#GEN-04
GEN-05 ریسلر با محتوا چه کارهایی می‌تواند بکند و چه کارهایی نه؟

ریسلر می‌تواند فهرست کانال‌ها، فیلم‌ها، سریال‌ها، رادیو، بوکه‌ها و پکیج‌ها راببیند(اگر گروهش مجوز داشته باشد)، اما نمی‌تواند محتوا اضافه، ویرایش یا حذف کند. محتوا و پکیج‌ها را ادمین مدیریت می‌کند. ریسلر با انتخاب پکیج (و بوکه‌ها، وقتی گروه اجازه دهد —PKG-05) تعیین می‌کند هر مشتری چه چیزی را می‌تواند تماشا کند.

#GEN-05
GEN-06 پشتیبانی را از کجا بگیرم؟

گزینهSupportدر نوار کناری، سایت جداگانه پشتیبانی را باز می‌کند. پنل سیستم تیکت مخصوص خودش را ندارد. هنگام ارسال درخواست این موارد را بنویسید: نام کاربری لاین (هرگز رمز عبور)، زمان وقوع مشکل، برنامه / دستگاه، و کد پرسش از این صفحه اگر قبلاً امتحانش کرده‌اید.

#GEN-06
GEN-07 رابط کاربری چه زبان‌هایی دارد؟

پنل، وب پلیر و این صفحه راهنما یک تعویض‌کننده زبان با ۲۷ زبان دارند. انگلیسی و ویتنامی ترجمه‌های مرجع هستند؛ در زبان‌های دیگر یک صفحه تازه اضافه‌شده ممکن است مدتی به انگلیسی بماند. ایمیل‌هایی که پنل می‌فرستد فعلاً فقط انگلیسی هستند.

#GEN-07

حساب‌های پنل و ورود

ACC
ACC-01 چرا مشتری من نمی‌تواند وارد داشبورد شود؟

این طراحی عمدی است: لاین یک حساب پنل نیست. مشتری فقط مشخصات لاین را در یک برنامه IPTV، ست‌تاپ‌باکس یا وب پلیر استفاده می‌کند. برعکس آن هم صادق است: با حساب ریسلر نمی‌توان کانال تماشا کرد.

#ACC-01
ACC-02 منوهای کمتری از آنچه این صفحه توضیح می‌دهد می‌بینم. چرا؟

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

#ACC-02
ACC-03 رمز عبور پنل را کجا تغییر دهم؟

در بخش حساب (profile → change password). رمزهای پنل به‌صورت هش ذخیره می‌شوند؛ هیچ‌کس نمی‌تواند آن‌ها را بخواند — حتی ادمین. اگر آن را فراموش کردید، از حساب بالادستی خود (ریسلر والد یا ادمین) بخواهید رمز جدیدی تنظیم کند.

#ACC-03
ACC-04 چرا وقتی شبکه را عوض می‌کنم از حساب خارج می‌شوم؟

پنل می‌تواند طوری تنظیم شود که با تغییر آدرس IP نشست را پایان دهد، تا نشست دزدیده‌شده قابل استفاده نباشد. دوباره وارد شوید. این یک تنظیم ادمین است.

#ACC-04
ACC-05 پس از چند بار ورود نادرست چه اتفاقی می‌افتد؟

پنل تعداد ورودهای ناموفق را محدود می‌کند (توسط ادمین تنظیم می‌شود). پس از رسیدن به حد مجاز، باید قبل از تلاش دوباره صبر کنید.

#ACC-05
ACC-06 حساب دمو با حساب واقعی چه فرقی دارد؟

حساب دمو فقط رابط کاربری را نشان می‌دهد: نمی‌تواند رمز عبورش را تغییر دهد، پروفایلش را ویرایش کند، کد فعال‌سازی بسازد یا کاری انجام دهد که قابل بازگشت نیست.

#ACC-06
ACC-07 حساب من «غیرفعال» (disabled) است. یعنی چه؟

حساب بالادستی شما آن را خاموش کرده است: نمی‌توانید وارد پنل شوید و کلیدهای API شما رد می‌شوند. لاین‌هایی که قبلاً فروخته شده‌اند حذف نمی‌شوند. با حساب بالادستی خود تماس بگیرید.

#ACC-07
ACC-08 کارهای خودم و زیرریسلرهایم را کجا مرور کنم؟

Logs → Reseller Logs(اگر گروه اجازه دیدن لاگ‌ها را داشته باشد): هر لاین یا دستگاهی که ساخته، ویرایش، تمدید، فعال / غیرفعال یا حذف شده، هر زیرریسلر ساخته‌شده و هر انتقال کردیت — همراه با کردیت کسرشده. فقط ورودی‌های خودتان و حساب‌های زیر دستتان را می‌بینید؛ لاگ قابل حذف نیست (فقط ادمین). دفتر کردیت (CRD) همچنان جای تطبیق موجودی است.

#ACC-08

کردیت

CRD
CRD-01 کردیت چیست؟

واحد پیش‌پرداخت پنل. هر فروش (ساخت لاین، تمدید، ساخت کدهای فعال‌سازی، ساخت زیرریسلر) بر اساس قیمت پکیج یا هزینه گروه کردیت کم می‌کند. کردیت پول نیست و پنل آن را تبدیل نمی‌کند: ارزش هر کردیت را شما و حساب بالادستی‌تان با هم توافق می‌کنید.

#CRD-01
CRD-02 چگونه کردیت شارژ کنم؟

کردیت از بالا به پایین جریان دارد: ادمین به ریسلر کردیت می‌دهد، ریسلر آن را به زیرریسلر منتقل می‌کند. پرداخت به حساب بالادستی خارج از پنل انجام می‌شود.

#CRD-02
CRD-03 کردیت چه کسی کسر می‌شود؟

همیشه کردیتحسابی که عملیات را انجام می‌دهد، حتی اگر لاین به زیرریسلر پایین‌تر اختصاص داده شده باشد.

#CRD-03
CRD-04 تاریخچه کردیتم را کجا ببینم؟

صفحهCredits: برای هر تغییر یک ردیف، با تاریخ، مبلغ، موجودی پس از آن، دلیل و فاعل. این همان دفتر کل است — منبع معتبر موجودی شما.

#CRD-04
CRD-05 اگر کردیت کافی نداشته باشم چه می‌شود؟

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

#CRD-05
CRD-06 اگر دو بار ذخیره را بزنم یا شبکه قطع شود، دو بار کسر می‌شود؟

خیر. هر درخواست فروش یک شناسه درخواست (request_id) دارد؛ ارسال دوباره همان شناسه نتیجه قبلی را برمی‌گرداند. ساخت لاین و کسر کردیت همیشه با هم موفق می‌شوند یا با هم لغو می‌شوند.

#CRD-06
CRD-07 با حذف یک لاین کردیت برمی‌گردد؟

خیر. حذف لاین چیزی را بازپرداخت نمی‌کند، حتی اگر زمان باقی مانده داشته باشد. تنها استثنا: حذف یککد فعال‌سازی استفاده‌نشدهکه خود ریسلر ساخته بازپرداخت می‌شود (CODE-08).

#CRD-07
CRD-08 آیا می‌توانم کردیتی را که به زیرریسلر منتقل کرده‌ام پس بگیرم؟

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

#CRD-08
CRD-09 چگونه از قبل بفهمم چند لاین می‌توانم بخرم؟

انتخابگر پکیج در فرم لاین قیمت مخصوص شما را نشان می‌دهد. از طریق API، اکشنpricingموجودی شما، قیمت هر پکیج و تعدادی که از عهده‌اش برمی‌آیید را برمی‌گرداند.

#CRD-09

پکیج‌ها، بوکه‌ها و قیمت‌ها

PKG
PKG-01 تفاوت بوکه و پکیج چیست؟

بوکه(bouquet) فهرستی از محتوا (کانال‌ها، فیلم‌ها، سریال‌ها) است.پکیج(package) محصولی است که می‌فروشید: یک یا چند بوکه، یک مدت، تعداد اتصال، فرمت‌های خروجی، قفل‌ها و قیمت به کردیت (قیمت رسمی و قیمت تریال).

#PKG-01
PKG-02 چرا یک پکیج مشخص را نمی‌بینم؟

یک پکیج را فقط گروه‌هایی که ادمین برای آن انتخاب کرده می‌توانند بفروشند. پکیجی که برای گروه شما نیست در انتخابگر نمایش داده نمی‌شود و اگر از طریق API ارسال شود رد می‌شود.

#PKG-02
PKG-03 قیمت من با قیمت پکیج فرق دارد. چرا؟

ادمین می‌تواند برای هر ریسلر و هر پکیج یکقیمت اختصاصیتعیین کند (۰ = رایگان). قیمت اختصاصی برای ساخت لاین رسمی، تمدید و کدهای فعال‌سازی رسمی اعمال می‌شود؛ برای تریال اعمالنمی‌شود.

#PKG-03
PKG-04 وقتی ادمین بوکه‌های یک پکیج را تغییر می‌دهد، لاین‌هایی که قبلاً فروخته شده‌اند هم تغییر می‌کنند؟

خیر. بوکه‌ها در زمان فروشدر لاین کپی می‌شوند؛ ویرایش بعدی پکیج روی لاین‌های فروخته‌شده تأثیری ندارد. لاین در تمدید / تغییر پکیج بعدی خود بوکه‌های جدید پکیج را می‌گیرد. (وقتی محتوایداخلیک بوکه تغییر کند، هر لاینی که آن بوکه را دارد بلافاصله آن را می‌بیند. حذف یک بوکه شناسه آن را از همه لاین‌ها و پکیج‌ها حذف می‌کند. تغییر ترتیب سراسری بوکه‌ها فقط وقتی ترتیب ذخیره‌شده روی لاین‌های فروخته‌شده را عوض می‌کند که کادر «apply to sold lines and packages» را تیک بزنید؛ مجموعه بوکه‌های لاین تغییر نمی‌کند.)

#PKG-04
PKG-05 آیا می‌توانم فقط بخشی از یک پکیج را بفروشم؟

فقط وقتی گروه شماAllow Bouquet Selectionرا روشن دارد: بخشی از بوکه‌های پکیج را تیک می‌زنید؛ هیچ تیکی = کل پکیج؛ بوکه‌های خارج از پکیج حذف می‌شوند. قیمت تغییر نمی‌کند.

#PKG-05
PKG-06 کدام ویژگی‌های لاین را پکیج تعیین می‌کند؟

تاریخ انقضا (امروز + مدت پکیج)، تعداد اتصال، فرمت‌های خروجی، ریستریمر، قفل دستگاه، کشور اجباری، سرور اجباری، قفل ISP، بوکه‌ها. مقادیری که ریسلر برای این فیلدها وارد می‌کند نادیده گرفته می‌شود، به‌جز بوکه‌ها (PKG-05) و قفل ISP وقتی گروهAllow Line Restrictionsرا روشن دارد.

#PKG-06
PKG-07 پکیج «MAG only» / «Enigma only» چیست؟

پکیجی که فقط برای آن نوع ست‌تاپ‌باکس قابل فروش است؛ برای لاین معمولی یا نوع دیگر دستگاه قابل فروش نیست. برعکس، یک پکیج باید نوع دستگاه را مجاز کرده باشد تا در فرم Add MAG / Add Enigma قابل استفاده باشد.

#PKG-07

لاین‌ها: ساخت، ویرایش، تمدید، حذف

LINE
LINE-01 برای ساخت لاین به چه چیزی نیاز دارم؟

باید پکیجی را که گروه شما اجازه فروشش را دارد انتخاب کنید و کردیت کافی داشته باشید. نام کاربری / رمز عبور: خودتان تایپ کنید (اگر گروه اجازه دهد) یا خالی بگذارید تا تولید شوند. ادمین هم هنگام ساخت لاین می‌تواند یکی از آن‌ها (یا هر دو) را خالی بگذارد: سیستم ۱۰ نویسه تولید می‌کند و بلافاصله پس از ذخیره نشان می‌دهد؛ فرمویرایشهمچنان به نام کاربری نیاز دارد.

#LINE-01
LINE-02 چرا نمی‌توانم نام کاربری / رمز عبور را خودم انتخاب کنم؟

گروه شماAllow Username Change/Allow Password Changeرا خاموش دارد: لاین جدید مقادیر تولیدشده می‌گیرد. وقتی اجازه دارید خودتان تایپ کنید، حداقل طول را گروه تعیین می‌کند (به‌طور پیش‌فرض ۸ نویسه).

#LINE-02
LINE-03 رمز عبور یک لاین را دوباره کجا ببینم؟

در فرم ویرایش لاین و در پنجرهGenerate play linkدر فهرست Lines. رمزهای لاین خوانا نگه داشته می‌شوند چون برنامه‌های IPTV و لینک‌های پلی‌لیست به آن نیاز دارند. رمز تولیدشده بلافاصله پس از ذخیره نشان داده می‌شود.

#LINE-03
LINE-04 یک لاین قدیمی رمز عبور نشان نمی‌دهد و مشتری نمی‌تواند وارد شود؟

بعضی لاین‌هایی که نسخه قبلی پنل ساخته فقط یک رمز هش‌شده دارند. چنین لاینینمی‌تواند وارد شودو پنل رمزی برای آن نشان نمی‌دهد. در فرم ویرایش لاین رمز جدیدی تنظیم کنید و برای مشتری بفرستید.

#LINE-04
LINE-05 ریسلر پس از فروش چه چیزهایی را در لاین می‌تواند ویرایش کند؟

فعال / غیرفعال کردن، یادداشت‌های ریسلر، تماس، قالب دسته‌بندی، مالک (در درخت خودتان)؛ نام کاربری و رمز عبور اگر گروه اجازه دهد؛ محدودیت‌ها (IPها، user agentها، قفل ISP) وقتی گروهAllow Line Restrictionsرا روشن دارد؛ انتخاب جدید بوکه‌ها در محدوده پکیج اگر گروه اجازه دهد. پکیج، تاریخ انقضا، تعداد اتصال، پرچم تریال، فرمت‌های خروجی، قفل دستگاه و کشور رانمی‌توانمستقیم ویرایش کرد — فقط با تمدید / تغییر پکیج تغییر می‌کنند.

#LINE-05
LINE-06 چگونه یک لاین را تمدید کنم؟

دو راه، یک قانون:

  • دکمهRenew (charged)در فهرست: از پکیج فعلی لاین استفاده می‌کند؛
  • فیلدExtend with packageدر فرم ویرایش: هر پکیجی را که اجازه فروشش دارید انتخاب کنید (تغییر پکیجهم از همین راه انجام می‌شود).

وقتی لاینی را ویرایش می‌کنید و در همان ذخیره تمدید هم انتخاب می‌کنید، هر دویک تراکنشهستند: اگر تمدید رد شود (کردیت کافی نیست، پکیج قابل فروش نیست)، ویرایش همذخیره نمی‌شودو کردیتی کسر نمی‌شود. آن را اصلاح کنید و دوباره ذخیره کنید.

#LINE-06
LINE-07 آیا هنگام تمدید زمان باقی‌مانده حفظ می‌شود؟
  • لاینمنقضی نشدهو پکیج جدید با قبلیسازگاراست → زمان به تاریخ انقضای فعلی اضافه می‌شود.
  • لاینمنقضی شدهیا دو پکیج سازگار نیستند → از امروز حساب می‌شود؛ زمان باقی‌مانده حفظ نمی‌شود.

«سازگار» فقط وقتی بررسی می‌شود که گزینه بررسی سازگاری در پکیج جدید روشن باشد: هر دو پکیج باید بوکه‌ها، فرمت‌های خروجی، تعداد اتصال، پرچم ریستریمر و قفل دستگاه یکسان داشته باشند. با خاموش بودن گزینه، همیشه سازگار حساب می‌شوند. پکیج‌های جدید به‌طور پیش‌فرض این گزینه را روشن دارند (ادمین می‌تواند خاموشش کند)؛ پکیج‌های موجود تنظیم خود را حفظ می‌کنند. لاین MAG / Enigma فقط با پکیجی تمدید یا تغییر داده می‌شود که آن نوع دستگاه را مجاز کرده باشد.

#LINE-07
LINE-08 تغییر پکیج (ارتقا / تنزل) چگونه محاسبه می‌شود؟

تغییر پکیج = خرید یک دوره رسمی از پکیج جدید: قیمت کامل پکیج جدید کسر می‌شود (قیمت اختصاصی شما اگر داشته باشید)، بدون اعتبار برای بخش استفاده‌نشده. لاین همه ویژگی‌های پکیج جدید را می‌گیرد.

#LINE-08
LINE-09 تفاوت غیرفعال کردن و حذف یک لاین چیست؟

غیرفعال کردن: مشتری نمی‌تواند وارد شود یا تماشا کند، نشست‌های جاری ظرف حدود یک دقیقه بسته می‌شوند؛ دوره اشتراک ادامه می‌یابد؛ هر زمان می‌توانید دوباره فعالش کنید.حذف: دائمی، بدون بازیابی، بدون بازپرداخت (DATA-01). برای مشتری‌ای که مکث می‌کند، غیرفعال کنید — حذف نکنید.

#LINE-09
LINE-10 وضعیت‌های لاین چه معنی‌ای دارند؟
Statusمعنیچه کسی می‌تواند برش دارد
Activeقابل استفاده—
Disabledتوسط ریسلر / مالک خاموش شدهریسلر
Bannedتوسط ادمین قفل شدهفقط ادمین
Expiredاز تاریخ انقضا گذشتهیک تمدید
Trialلاین تریال، تا پایان دوره تریال قابل استفادهبا تمدید رسمی می‌شود
#LINE-10
LINE-11 وقتی یک لاین منقضی می‌شود چه اتفاقی می‌افتد؟

تا زمان تمدید لاین، مشتری رد می‌شود (لاینی که هم منقضی و هم بن شده کلیپ «expired» را می‌بیند، چون انقضا اول بررسی می‌شود)؛ نشست‌های جاری ظرف حدود یک دقیقه بسته می‌شوند. لاین به‌طور خودکارحذف نمی‌شود: تمدیدش کنید و با همان نام کاربری / رمز عبور دوباره کار می‌کند.

#LINE-11
LINE-12 آیا می‌توانم یک لاین را به زیرریسلر بدهم؟

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

#LINE-12
LINE-13 لاین‌های چه کسانی را می‌بینم؟

لاین‌های خودتان و لاین‌های همه حساب‌های زیر دستتان. لاینی خارج از درخت شما برای شما وجود ندارد (پاسخ «یافت نشد» است).

#LINE-13
LINE-14 فیلدهای «Contact» و «Reseller notes» برای چیست؟

برای اینکه خودتان به یاد داشته باشید مشتری کیست (ایمیل، شماره تلفن، شماره سفارش). مشترک هرگز آن‌ها را نمی‌بیند. با حذف لاین برای همیشه پاک می‌شوند.

#LINE-14
LINE-15 آیا می‌توانم ببینم یک لاین چه چیزی و از کجا تماشا می‌کند؟

وقتی گروه مجوز داشته باشد:Logs → Line Activityتاریخچه تماشای هر لاین را نشان می‌دهد وLogs → Live Connectionsهمه اتصالات باز لاین‌های درخت شما را نشان می‌دهد (کدام لاین، کدام کانال، از کدام آدرس) همراه با دکمه بستن آن. Live Connections فقط وقتی باز می‌شود که ادمین برای گروه شما گزینه دیدن تاریخچه اتصال مشتریان را روشن کرده باشد (کادرclient connection logsدر فرم گروه)؛ اتصالات لاینی خارج از درخت خود را هرگز نمی‌بینید.

#LINE-15
LINE-16 چرا فهرست Lines لاین‌های کدهای فعال‌سازی را نشان نمی‌دهد؟

لاینی که متعلق به یک کد فعال‌سازی است به‌طور پیش‌فرض از فهرست پنهان است تا زمانی که برایش فیلتر کنید (CODE-02).

#LINE-16
LINE-17 آیا تاریخ انقضا در فرم لاین ساعت هم دارد؟ ادمین

بله. فیلدExpires onدر فرم لاین یک تاریخو ساعتدر منطقه زمانی پنل است، پس یک لاین می‌تواند در ساعت مشخصی منقضی شود. باز کردن فرم و ذخیره بدون دست زدن به این فیلد انقضا را تا ثانیه حفظ می‌کند — ویرایش یک یادداشت یا بوکه‌ها به لاین تریال ساعتی زمان اضافه نمی‌دهد. مقداری که خوانده نشود در همان فیلد گزارش می‌شود و هرگز به «هرگز منقضی نمی‌شود» تبدیل نمی‌شود. صفحه ویرایش گروهی همچنان تاریخ می‌گیرد و آن را پایان همان روز می‌خواند.

#LINE-17

تریال

TRI
TRI-01 چه زمانی می‌توانم لاین تریال بسازم؟

وقتیهمهاین شرایط برقرار باشند: ادمین تریال را برای ریسلرها خاموش نکرده باشد؛ پکیج دوره تریال داشته باشد؛ گروه شماAllowed Trials> 0 داشته باشد؛ کردیت شما ≥Minimum Trial Creditsگروه باشد؛ و تعداد لاین‌های تریالی که در بازه شمارش ساخته‌اید به سهمیه نرسیده باشد.

#TRI-01
TRI-02 سهمیه تریال در چه بازه‌ای شمرده می‌شود؟

طبق تنظیم گروه:روز= ۲۴ ساعت گذشته،ماه= ۳۰ روز گذشته. مثال، سهمیه ۵ / روز: حداکثر ۵ لاین تریال در هر ۲۴ ساعت. یک تریال قدیمی‌تر وقتی از بازه خارج شود جای خود را آزاد می‌کند.

#TRI-02
TRI-03 آیا تریال کردیت خرج می‌کند؟

دقیقاً قیمت تریال پکیج (معمولاً ۰). قیمت اختصاصی ریسلر برای تریال اعمال نمی‌شود.

#TRI-03
TRI-04 چرا کادر تریال قفل است؟

یکی از شرایطTRI-01برقرار نیست؛ فرم دلیل آن را کنار کادر نوشته است.

#TRI-04
TRI-05 چگونه تریال را به لاین رسمی تبدیل کنم؟

لاین را با یک پکیج تمدید کنید: لاین یک دوره رسمی می‌گیرد و دیگر تریال نیست. نام کاربری و رمز عبور همان می‌ماند، مشتری لازم نیست دوباره چیزی را تنظیم کند.

#TRI-05
TRI-06 آیا می‌توانم به یک لاین موجود دوره تریال دیگری بدهم؟

خیر. تریالیک بار، هنگام ساخت لاینداده می‌شود؛ یک لاین موجود را فقط می‌توان با دوره رسمی تمدید کرد (TRI-05). برای اینکه مشتری دوباره امتحان کند، یک لاین تریال جدید بسازید (در سهمیه تریال حساب می‌شود).

#TRI-06

لینک‌های پخش، برنامه‌ها و فرمت‌ها

PLAY
PLAY-01 لینک مشتری‌ام را از کجا بگیرم؟

Lines → Generate play link: فرمت را انتخاب کنید؛ لینک با نام کاربری و رمز عبور لاین ساخته می‌شود. از طریق API،get_lineلینک‌ها را آماده برمی‌گرداند:m3u،m3u_hls،xmltv،player_api،web_player.

#PLAY-01
PLAY-02 مشتری از چه برنامه‌هایی می‌تواند استفاده کند؟ بیننده

هر برنامه‌ای که ازXtream Codes APIپشتیبانی کند (IPTV Smarters، TiviMate، XCIPTV، GSE…): آدرس سرور + نام کاربری + رمز عبور را وارد کنید. برای برنامه‌ای که فقط پلی‌لیست می‌گیرد از لینکM3Uاستفاده کنید. دستگاه‌هایMAGاز پورتال و دستگاه‌هایEnigma2از پلی‌لیست / پلاگین استفاده می‌کنند. بدون هیچ دستگاهی، ازوب پلیردر مرورگر استفاده کنید.

#PLAY-02
PLAY-03 MPEG-TS یا HLS؟

MPEG-TS: تعویض سریع کانال، مناسب برنامه‌های IPTV و ست‌تاپ‌باکس‌ها.HLS: در مرورگرها، دستگاه‌های اپل و شبکه‌های ناپایدار خوب کار می‌کند. یک لاین فقط می‌تواند از فرمت‌هایی که پکیجش مجاز کرده استفاده کند؛ لینک با فرمت غیرمجاز رد می‌شود.

#PLAY-03
PLAY-04 چه نوع پلی‌لیست‌هایی وجود دارد؟

m3u_plus(با لوگو، گروه‌ها، شناسه‌های EPG — پیش‌فرض پیشنهادی)،m3uساده، نوع‌های Enigma2 / DreamBox / GigaBlue / Octagon / MediaStar / StarLive، و نوع‌های فهرست ساده. در پنجره Generate play link یکی را انتخاب کنید.

#PLAY-04
PLAY-05 راهنمای برنامه (EPG) از کجا می‌آید؟ بیننده

برنامه‌های Xtream آن را خودشان دریافت می‌کنند. برای برنامه M3U از لینکXMLTVلاین استفاده کنید (پلی‌لیستm3u_plusاز قبل آدرس EPG را دارد).

#PLAY-05
PLAY-06 آیا catch-up وجود دارد؟ بیننده

بله، روی کانال‌هایی که ادمین آرشیو را برایشان فعال کرده؛ برنامه‌ها روی آن کانال‌ها نماد catch-up نشان می‌دهند.

#PLAY-06
PLAY-07 وب پلیر کجاست و چگونه وارد شوم؟ بیننده

در/player/روی سرور API (لینکweb_player). با نام کاربری / رمز عبور لاین یا با یک کد فعال‌سازی وارد شوید.

#PLAY-07
PLAY-08 پس از تغییر رمز عبور لاین، لینک قدیمی هنوز کار می‌کند؟

خیر. رمز عبور بخشی از لینک است و در برنامه ذخیره می‌شود؛ پس از تغییر رمز، مشتری باید آن را دوباره وارد کند / لینک جدید بگیرد. قطع دسترسی کسی که بدون اجازه از یک لاین استفاده می‌کند هم از همین راه انجام می‌شود.

#PLAY-08
PLAY-09 آیا می‌توانم از دامنه خودم برای لینک‌های پخش استفاده کنم؟

بله:Your own play addressرا در صفحه کلید API تنظیم کنید (یا با اکشن API به نامset_play_base). DNS دامنه را به سرور API پنل اشاره می‌دهید،واپراتور باید سمت خودش را پیکربندی کند؛ پیش از استفاده به ادمین بگویید. این آدرس روی لینک‌هایی که API به سیستم شما برمی‌گرداند اعمال می‌شود.

#PLAY-09
PLAY-10 آیا می‌توانم یک لینک را به چند نفر بدهم؟

از نظر فنی آن‌ها یک لاین را به اشتراک می‌گذارند، پستعداد اتصالآن را (SEC-01) به اشتراک می‌گذارند و ممکن است به قانون IP دوم (SEC-03) برخورد کنند. هر مشتری باید لاین مخصوص خودش را داشته باشد.

#PLAY-10

ست‌تاپ‌باکس‌های MAG / Enigma2

DEV
DEV-01 چگونه یک دستگاه MAG / Enigma اضافه کنم؟

Devices → Add MAG / Add Enigma: MAC را وارد کنید، یک پکیج انتخاب کنید. سیستم یک لاین جدید می‌فروشد و دستگاه را در یک مرحله به آن وصل می‌کند؛ دستگاه با MAC خود وارد می‌شود و کسی لازم نیست نام کاربری / رمز عبور تایپ کند. کردیت دقیقاً مثل لاین معمولی کسر می‌شود.

#DEV-01
DEV-02 مشتری از قبل لاین دارد و می‌خواهد یک دستگاه اضافه کند؟

در فرم دستگاه، به‌جای پکیجلاین موجودمشتری را انتخاب کنید: دستگاه با آن لاینجفتمی‌شود، رایگان. مشتری همچنان لاین را در برنامه استفاده می‌کند؛ دستگاه از پکیج، انقضا، بوکه‌ها و وضعیت لاین پیروی می‌کند.

#DEV-02
DEV-03 اتصالات برنامه و دستگاهِ جفت‌شده چگونه شمرده می‌شوند؟

آن‌ها محدودیت اتصال رابه اشتراکمی‌گذارند: برنامه و دستگاه یک مشترک هستند.

#DEV-03
DEV-04 چگونه یک دستگاه را تمدید کنم؟

لاین آن را تمدید کنید (پیوند در فرم دستگاه است). برای دستگاه جفت‌شده، لاین مشتری را تمدید کنید — دستگاه خودکار دنبال می‌کند.

#DEV-04
DEV-05 مشتری دستگاه را با دستگاه جدید عوض می‌کند؟

MAC را روی دستگاه ویرایش کنید. اگر لاین قفل دستگاه را روشن دارد، شماره سریال / شناسه دستگاه ثبت‌شده را پاک کنید تا دستگاه جدید بتواند ثبت شود.

#DEV-05
DEV-06 آیا حذف یک دستگاه لاین را هم حذف می‌کند؟

بله. حذف دستگاه لاین آن را هم حذف می‌کند (با تاریخچه اتصال و رویدادهای در انتظار)، مثل پنل قدیمی. برای نگه داشتن لاینی که پولش پرداخت شده، از دکمهConvert to lineاستفاده کنید: دستگاه حذف می‌شود و لاین به یک لاین معمولی تبدیل می‌شود. وقتی لاین مشتری را حذف کنید، دستگاه جفت‌شده مستقل و با لاین مخصوص خودش باقی می‌ماند.

#DEV-06
DEV-07 آیا ریسلر می‌تواند دستگاه را از راه دور کنترل کند؟

دستگاه‌هایMAGخودش را بله: ارسال پیام به تلویزیون، پخش یک کانال، بارگذاری مجدد پورتال، ری‌بوت، بستن اتصالات لاین (گروه برای دیدن لاگ اتصالات مشتریان به مجوز نیاز دارد)، ریست ISP ثبت‌شده و ریست قفل STB. دستورهای X-Plugin و اسکرین‌شات دستگاه‌هایEnigma، بن کردن دستگاه و انتقال دستگاه به لاین دیگر فقط برای ادمین است. فعال / غیرفعال کردن دستگاه ریسلر، لاین آن را فعال / غیرفعال می‌کند؛ ریسلر نمی‌تواندBannedرا از یک دستگاه بردارد.

#DEV-07

کدهای فعال‌سازی

CODE
CODE-01 کد فعال‌سازی برای چیست؟

فروش دسترسی به‌صورت یک کد (کارت خراشیدنی، کدی که با پیام فرستاده می‌شود): مشتری کد را در یک برنامه یا در وب پلیر وارد می‌کند و بدون نام کاربری / رمز عبور می‌تواند تماشا کند. دورهفقط از اولین باری شروع می‌شود که مشتری کد را فعال می‌کند.

#CODE-01
CODE-02 چگونه کد بسازم و هزینه آن چقدر است؟

Active Codes → New: پکیج، تعداد (۱ تا ۵۰۰ در هر دسته)، طول کد (۶ تا ۲۴)، گزینه فقط‌رقم (تایپ آسان با ریموت تلویزیون) و گزینه تریال را انتخاب کنید. کردیتهنگام ساختکسر می‌شود = قیمت پکیج × تعداد کدها. هر کد با یک لاین مخصوص خودش می‌آید که تا زمان فعال‌سازی قفل است.

#CODE-02
CODE-03 کد شامل چه نویسه‌هایی است؟

حروف بزرگ و ارقام بدون نویسه‌هایی که به‌راحتی با هم اشتباه می‌شوند (0، O، 1، I)؛ یا فقط ارقام. اگر مشتری با حروف کوچک تایپ کند باز هم پذیرفته می‌شود.

#CODE-03
CODE-04 یک کد روی چند دستگاه قابل استفاده است؟ بیننده

یک دستگاه. کد به اولین دستگاهی که آن را فعال می‌کند گره می‌خورد؛ دستگاه دیگری که همان کد را وارد کند رد می‌شود. آن دستگاه هر چند بار بخواهد می‌تواند کد را وارد کند، مشخصات ورود لاین تغییر نمی‌کند.

#CODE-04
CODE-05 اگر مشتری دستگاه را عوض کند چه؟

روی آن کدReset deviceرا بزنید؛ سپس دستگاه جدید می‌تواند آن را فعال کند. زمانی به دوره اضافه نمی‌شود.

#CODE-05
CODE-06 مشتری هنگام وارد کردن کد خطا می‌گیرد. یعنی چه؟ بیننده
Messageمعنیچه کار کنید
INVALID_CODEکد اشتباه است / کد وجود نداردتک‌تک نویسه‌ها را بررسی کنید؛ خط تیره‌ها را تایپ نکنید
DEVICE_MISMATCHکد به دستگاه دیگری گره خوردهریسلر دستگاه را ریست می‌کند (CODE-05)
DISABLEDکد خاموش شدهریسلر دوباره فعالش می‌کند
EXPIREDدوره تمام شدهکد بخرید / تمدید کنید

وارد کردن پشت‌سرهم چند کد اشتباه متفاوت باعث می‌شود آدرس IP برای مدتی مسدود شود (SEC-08).

#CODE-06
CODE-07 چگونه کدی را که فعال شده تمدید کنم؟

در صفحهActive Codesکد را تیک بزنید، عملیاتExtend (days)را انتخاب کنید و تعداد روز را وارد کنید. فقط به کدفعال‌شدهروز اضافه می‌شود (کد استفاده‌نشده هنوز دوره‌اش شروع نشده)؛ کدی که هنوز معتبر است از تاریخ انقضای فعلی و کد منقضی‌شده از همین الان تمدید می‌شود. این عملیات کردیت کسر نمی‌کند. از طریق API:extend_active_code.

#CODE-07
CODE-08 با حذف یک کد کردیت برمی‌گردد؟

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

#CODE-08
CODE-09 چگونه تعداد زیادی کد را یکجا مدیریت کنم؟

صفحهBatchesبرای هر دسته مجموع / آماده / فعال‌شده / غیرفعال را نشان می‌دهد و یک فایل TXT (هر خط یک کد) خروجی می‌دهد. عملیات گروهی: فعال کردن، غیرفعال کردن، ریست دستگاه، حذف.

#CODE-09
CODE-10 آیا لاین یک کد فعال‌سازی از محدودیت‌های پکیج پیروی می‌کند؟

بله، مثل هر لاینی که با آن پکیج فروخته شده: تعداد اتصال، فرمت‌های خروجی، بوکه‌ها، قفل دستگاه، ریستریمر و همچنینکشور اجباریپکیج (SEC-07). مشتری‌ای که کد را از کشوری خارج از فهرست مجاز فعال کند می‌تواند آن را فعال کند اما هنگام پخش رد می‌شود.

#CODE-10

محدودیت اتصال و قفل‌هایی که از لاین محافظت می‌کنند

SEC
SEC-01 «Max connections» چگونه شمرده می‌شود؟

تعداد دستگاه‌هایی است کههمزمانبا یک لاین تماشا می‌کنند. ۰ = نامحدود. باز کردن دوباره کانالی که همین الان از همان دستگاه تماشا می‌کنید اتصال دیگری حساب نمی‌شود.

#SEC-01
SEC-02 وقتی از حد مجاز بگذرد چه کسی قطع می‌شود؟ بیننده

به‌طور پیش‌فرض: اتصالجدیدوارد می‌شود وقدیمی‌تریناتصال بسته می‌شود (اتصال از همان دستگاه و سپس از همان IP ترجیح داده می‌شود). پلیر بسته‌شده ظرف حدود ۳۰ ثانیه متوقف می‌شود. ادمین می‌تواند به‌جای بستن اتصال قدیمی،رد کردن اتصال جدیدرا انتخاب کند.

#SEC-02
SEC-03 قانون «IP دوم» چیست؟

وقتی ادمین آن را روشن کرده باشد: تا زمانی که یک لاین از یک IP تماشا می‌شود، اتصال زنده از IP دیگر رد می‌شود. این قانون را می‌توان به لاین‌های با اتصال کم محدود کرد (مثلاً لاین‌های با ۱ اتصال؛ لاین با اتصال نامحدود فقط وقتی آستانه ۰ باشد مقید می‌شود). با روشن بودنMatch The Address By Network، آدرس‌های یک شبکه /24 (در IPv6: /64) یک بیننده حساب می‌شوند. این ابزاری علیه اشتراک‌گذاری حساب است.

#SEC-03
SEC-04 آیا می‌توانم یک لاین را به IPها یا برنامه‌های مشخص محدود کنم؟

وقتی گروهAllow Line Restrictionsرا روشن دارد: فیلدAllowed IPs(یک IP، یک محدوده CIDR یا یک نام دامنه، هر کدام در یک خط؛ دامنه هنگام اتصال بررسی می‌شود، پس IP پویا هم کار می‌کند) وAllowed User-Agents. خالی = همه مجاز. توجه: این محدودیت‌ها درپخشمسدود می‌کنند؛ برنامه همچنان وارد می‌شود و فهرست کانال‌ها را نشان می‌دهد.

#SEC-04
SEC-05 قفل ISP چیست؟

لاین ارائه‌دهنده اینترنت اولین اتصال خود را به خاطر می‌سپارد و استفاده از ارائه‌دهنده دیگر را رد می‌کند. وقتی مشتری ارائه‌دهنده را عوض کرد، قفل ISP را خاموش و دوباره روشن کنید تا مورد جدید ثبت شود. روی دستگاه‌های MAG اعمال نمی‌شود.

#SEC-05
SEC-06 قفل دستگاه چیست؟

لاین را به اولین ست‌تاپ‌باکسی که وارد می‌شود (شماره سریال، شناسه دستگاه) گره می‌زند؛ دستگاه دیگر رد می‌شود. توسط پکیج تعیین می‌شود.

#SEC-06
SEC-07 محدودیت کشور چگونه کار می‌کند؟

یک لاین فقط از کشور اجباری خود می‌تواند متصل شود (ALL= هر جا). وقتی خالی باشد، فهرست کلی کشورهای مجاز پنل اعمال می‌شود. مشتری‌ای که به خارج سفر می‌کند یا از VPN استفاده می‌کند ممکن است به همین دلیل رد شود.

#SEC-07
SEC-08 چرا یک آدرس IP مسدود شده است؟ بیننده
  • خودکار: ورودهای ناموفق از یک IP با نام‌های کاربری / کدهای فعال‌سازی متفاوت بسیار در زمان کوتاه، یا سیل درخواست‌ها. مسدودسازی خودکار پس از مدتی که ادمین تنظیم کرده (به‌طور پیش‌فرض ۶۰ دقیقه) خودش برداشته می‌شود.
  • دستی: ادمین IP / محدوده IP را مسدود کرده؛ این منقضی نمی‌شود.

تا زمانی که یک IP مسدود است،هیچلاینی نمی‌تواند از آن متصل شود. اشتباه تایپ کردن مکرر همان نام کاربری باعث مسدودسازی نمی‌شود.

#SEC-08
SEC-09 به چه دلایل دیگری یک اتصال ممکن است مسدود شود؟

ادمین می‌تواند بر اساسUser-Agent(برنامه)،ارائه‌دهنده اینترنت (ISP)وASN(مثلاً محدوده‌های هاستینگ / VPN) مسدود کند. لاینی که ادمین برایش «bypass UA» را روشن کرده، فهرست مسدودی برنامه‌ها را رد می‌کند.

#SEC-09
SEC-10 ریستریمر چیست؟

لاینی برای یک شریک که استریم‌ها را می‌کشد تا دوباره توزیع کند. از محدودیت اتصال، قانون IP دوم، پایان خودکار نشست‌های طولانی و مسدودسازی ASN معاف است. توسط پکیج / ادمین تعیین می‌شود؛ برای بینندگان عادی در نظر گرفته نشده است.

#SEC-10
SEC-11 آیا یک نشست پیوسته بسیار طولانی قطع می‌شود؟ بیننده

ادمین می‌تواند حداکثر مدت یک نشست پیوسته را تنظیم کند؛ پس از آن نشست بسته می‌شود و مشتری برای ادامه پخش را می‌زند. نشستی که حدود ۹۰ ثانیه سیگنال را از دست بدهد هم بسته حساب می‌شود.

#SEC-11
SEC-12 چگونه لاینی را که به اشتراک گذاشته شده یا دزدیده شده تشخیص دهم؟
  • صفحهTheft Detection(اگر گروه مجوز داشته باشد): لاین‌ها را بر اساس تعداد فیلم‌ها / قسمت‌هایمتفاوتتماشاشده در ۱ ساعت / ۲۴ ساعت / ۷ روز رتبه‌بندی می‌کند، همراه با تعداد IPهای متفاوت — لاینی با مقدار غیرعادی بالا مشکوک است.
  • صفحه فعالیت لاین: IPها و دستگاه‌های در حال استفاده را نشان می‌دهد.
  • چه باید کرد: رمز عبور لاین را تغییر دهید (PLAY-08)، محدودیت IP / قفل ISP را روشن کنید، یا لاین را غیرفعال کنید.
#SEC-12

زیرریسلرها

SUB
SUB-01 آیا می‌توانم زیرریسلر بسازم؟

وقتی گروه شماCan Create Sub-Resellersرا روشن دارد و دست‌کم یک گروه درGroups for sub-resellersباشد. هر ساخت، هزینه ساخت (کردیت) تنظیم‌شده روی گروه را کسر می‌کند. درخت ریسلرها حداکثر ۵ سطح عمق دارد.

#SUB-01
SUB-02 زیرریسلر به کدام گروه تعلق دارد و چه کارهایی می‌تواند بکند؟

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

#SUB-02
SUB-03 روی یک زیرریسلر چه چیزهایی را می‌توانم مدیریت کنم؟

ایمیل، نام، رمز عبور، وضعیت، گروه (از فهرست)، یادداشت‌ها، انتقال / پس گرفتن کردیت، و همه لاین‌های زیر دست او. نقش یا مالک او را نمی‌توانید تغییر دهید.

#SUB-03
SUB-04 زیرریسلر از اطلاعات من چه چیزی می‌بیند؟

هیچ چیز: هر حساب فقط آنچه را زیر خودش است می‌بیند، هرگز سطوح بالاتر یا شاخه‌های دیگر را.

#SUB-04
SUB-05 وقتی یک زیرریسلر را حذف کنم، لاین‌ها و کردیت‌هایش به کجا می‌روند؟

گروه بایدCan Delete Usersرا روشن داشته باشد. کردیت باقی‌مانده، لاین‌ها و حساب‌های فرزند بهحسابی که حذف می‌کندمنتقل می‌شوند. لاین‌های مشتریان به کار خود ادامه می‌دهند. داده‌های شخصی حساب حذف‌شده (نام کاربری، ایمیل، نام، رمز عبور، کلیدهای API، یادداشت‌ها) پاک می‌شود؛ آن نام کاربری و ایمیل دوباره قابل استفاده است.

#SUB-05
SUB-06 آیا زیرریسلر جدید ایمیل دریافت می‌کند؟

وقتی ادمین ایمیل خوش‌آمدگویی را فعال کرده باشد: حساب جدید نام ورود و پیوند ورود را دریافت می‌کند. ایمیلهرگزرمز عبور را ندارد — رمز را خودتان برایشان می‌فرستید.

#SUB-06

قالب‌های دسته‌بندی

CAT
CAT-01 قالب دسته‌بندی برای چیست؟

برای بازچینی، تغییر نام یا پنهان کردن دسته‌هایی (زنده، فیلم، سریال، رادیو) که مشتری در برنامه می‌بیند — برای هر لاین، بدون دست زدن به دسته‌های خود پنل.

#CAT-01
CAT-02 وقتی یک دسته را پنهان کنم چه می‌شود؟

همه محتوای آن دسته هم از برنامه و پلی‌لیست لاین‌هایی که از آن قالب استفاده می‌کنند پنهان می‌شود.

#CAT-02
CAT-03 وقتی یک قالب را ویرایش کنم، لاین‌هایی که از آن استفاده می‌کنند تغییر می‌کنند؟

بله، بلافاصله برای همه لاین‌هایی که قالب به آن‌ها اختصاص دارد. وقتی قالبی حذف شود، لاین‌هایش به چیدمان پیش‌فرض برمی‌گردند.

#CAT-03
CAT-04 کدام قالب‌ها را می‌توانم ببینم و ویرایش کنم؟

دیدن: قالب‌های خودتان و حساب‌های زیر دستتان، قالب‌های سیستمی و قالب‌های اشتراکی سطوح بالاتر. ویرایش: فقط قالب‌های خودتان و زیر دستتان. برای تنظیم یک قالب سیستمی، آن راکپیکنید و نسخه کپی را ویرایش کنید.

#CAT-04
CAT-05 محدودیت‌هایی که باید دانست؟

ترتیب سفارشی دسته‌ها روی بخش فیلم / سریال پلی‌لیست M3U اعمال نمی‌شود (نام‌ها و پنهان‌سازی همچنان اعمال می‌شوند). برنامه‌هایی که از Xtream API استفاده می‌کنند همه چیز را می‌گیرند.

#CAT-05

Reseller API، کلیدهای API، وب‌هوک‌ها

API
API-01 Reseller API برای چیست؟

برای اینکه سیستم خودتان (فروشگاه وب، صورتحساب، بات) بدون باز کردن داشبورد لاین / زیرریسلر بفروشد و مدیریت کند. آدرس:{API}/reseller/v1، با هدرX-API-Keyاحراز هویت می‌شود. مستندات کامل در/docs/روی سرور API است.

#API-01
API-02 کلید API را از کجا بگیرم؟

صفحهAPI Key. کلیدیک بار، هنگام ساخت نشان داده می‌شود — بلافاصله کپی‌اش کنید. اگر گمش کردید، کلید جدیدی بسازید (کلید قدیمی از کار می‌افتد).

#API-02
API-03 آیا برای همه سیستم‌ها یک کلید استفاده کنم؟

بهتر است نه. برای هر سیستم یککلید اضافیبسازید: نامی بدهید، IPها / CIDRهایی را که می‌توانند از آن استفاده کنند محدود کنید، در صورت نیاز آن رافقط‌خواندنیکنید (فقط فهرست و مشاهده) و بدون تأثیر بر کلیدهای دیگر جداگانه لغوش کنید.

#API-03
API-04 API چه کارهایی می‌تواند بکند؟
NeedAction
موجودی، قیمت‌ها، تعدادی که از عهده‌اش برمی‌آیید، قوانین نام کاربری / تریالuser_info,pricing,packages
لاین‌هاget_lines,get_line,create_line,renew_line,change_package,edit_line,enable_line,disable_line,delete_line
زیرریسلرهاget_users,get_user,create_user,edit_user,adjust_credits,enable_user,disable_user,delete_user
کدهای فعال‌سازیساخت، فهرست، فعال / غیرفعال، ریست دستگاه، حذف
وب‌هوک‌ها، آدرس پخش اختصاصی، لاگ فراخوانی‌های APIcreate_webhook…,set_play_base,api_logs

هر قانون داشبورد (گروه، قیمت اختصاصی، سهمیه تریال، دامنه درخت) دقیقاً به همان شکل از طریق API هم اعمال می‌شود.

#API-04
API-05 اگر پس از خطای شبکه دوباره تلاش کنم، دو بار کسر می‌شود؟

خیر، به شرطی که برای همان تراکنش همانrequest_idرا بفرستید: سیستم نتیجه قبلی را برمی‌گرداند.request_idیک تمدیدبه آن لاین گره خورده است: استفاده از آن برای لاین دیگر خطای تعارض (HTTP 409) برمی‌گرداند و لاین دیگر تغییر نمی‌کند — برای هر تراکنش یکrequest_idجدید بسازید.

#API-05
API-06 یکپارچه‌سازی من کار نمی‌کند. چگونه خودم بررسی کنم؟

صفحه API Key جدولی ازفراخوانی‌های اخیر API(۳۰ روز) دارد: اکشن، نتیجه، کد خطا، آدرس فراخواننده، نام کانکتور. پارامترها هرگز ثبت نمی‌شوند.

#API-06
API-07 وب‌هوک چیست و چه رویدادهایی وجود دارد؟

پنل وقتی اتفاقی می‌افتد به سیستم شما خبر می‌دهد، تا مجبور نباشید مدام بپرسید. رویدادها:line.created،line.renewed،line.enabled،line.disabled،line.deleted،line.expiring(۳ روز قبل)،line.expired،credits.low(زیر آستانه‌ای که تعیین کرده‌اید). آدرس دریافت‌کننده باید https و از اینترنت در دسترس باشد.

#API-07
API-08 چگونه بفهمم یک وب‌هوک اصیل است؟

هر اعلان امضایX-Xtream-Signature: sha256=HMAC(secret, timestamp.body)را دارد؛ secret یک بار، هنگام ساخت endpoint نشان داده می‌شود. وب‌هوک هرگز رمز عبور ندارد.

#API-08
API-09 وب‌هوک ارسال را متوقف کرده؟

هر اعلان ۳ بار تلاش می‌شود؛ endpointی که ۲۰ ارسال پشت‌سرهم ناموفق باشد خاموش می‌شود. سمت خودتان را درست کنید، ازSend testاستفاده کنید، و اگر خاموش شده بود endpoint را دوباره بسازید.

#API-09
API-10 آیا API رمز عبور لاین‌ها را برمی‌گرداند؟

بله، اما فقط به مالک لاین (شما و سطوح بالاتر در درخت). رمز عبور لاین‌ها را در لاگ‌ها ذخیره نکنید و از کانال ناامن نفرستید.

#API-10
API-11 آیا `edit_line` می‌تواند یک لاین را تمدید کند؟

بله، وقتیpackage_idرا همراهش بفرستید (نام قدیمیpackageهم پذیرفته می‌شود): علاوه بر ویرایش، این اکشن دقیقاً مثلchange_packageیک دوره رسمی از آن پکیج می‌فروشد — همان قیمت، همانrequest_id، و پاسخcredits_chargedرا دارد. ویرایش و تمدید یک تراکنش هستند: اگر رد شود (کردیت کافی نیست، پکیج نامعتبر،trialهمراه فرستاده شده) هیچ چیز تغییر نمی‌کند.edit_lineبدونپکیج فقط نام کاربری، رمز عبور، تماس و یادداشت‌ها را ویرایش می‌کند و به پکیج یا انقضا دست نمی‌زند.

#API-11
API-12 آیا اسکریپتی که برای پنل قدیمی (PHP) نوشته شده با این API کار می‌کند؟

نه به همان شکل. API نام اکشن‌های آشنا را نگه داشته اما یک رابط جدید است: آدرس/reseller/v1، کلید API ساخته‌شده در همین پنل، اکشن‌های نوشتن با POST، خطاها به‌صورت وضعیت HTTP با فیلدerror، و نتیجه ساخت لاین درdata.line. از مستندات/docs/یا یک کانکتور آماده (CON-02) استفاده کنید.

#API-12

کانکتورها برای سیستم‌های فروشگاه / صورتحساب

CON
CON-01 چگونه از مشتریانم پول دریافت کنم؟

با سیستم و درگاه پرداختخودتان. پنل پرداخت را پردازش نمی‌کند. کانکتور سیستم فروشگاه شما را به پنل وصل می‌کند: مشتری در سمت شما پرداخت می‌کند → کانکتور Reseller API را برای ساخت / تمدید لاین فراخوانی می‌کند.

#CON-01
CON-02 برای چه پلتفرم‌هایی کانکتور وجود دارد؟

WHMCS، Blesta، WISECP، HostBill، ClientExec، FOSSBilling، Paymenter، WordPress (WooCommerce / Easy Digital Downloads)، Odoo، PrestaShop، OpenCart، Magento، Dolibarr، ERPNext، و یک «webhook bridge» برای Shopify، Upmind و Invoice Ninja.

#CON-02
CON-03 از کجا دانلود و نصب کنم؟

نوار کناریResources → All Connectors: هر کانکتور توضیحات، مشخصات اتصال، مراحل نصب، دکمهDownloadو SHA-256 فایل برای راستی‌آزمایی دارد.

#CON-03
CON-04 کانکتورها تا چه حد آزمایش شده‌اند؟

برای هر کانکتور فرق دارد و صفحه هر کانکتور آن را می‌گوید: بعضی داخل پلتفرم واقعی اجرا شده‌اند (مثلاً WordPress + WooCommerce، Odoo، FOSSBilling، Paymenter)، بعضی فقط هسته‌شان آزمایش شده. خط «how it was tested» را بخوانید و پیش از فروش واقعی در محیط آزمایشی امتحان کنید.

#CON-04
CON-05 آیا کانکتور امن است و با پنل چه می‌کند؟

کانکتور فقط Reseller API را با کلید APIخودتانفراخوانی می‌کند — دقیقاً همان کاری را می‌تواند بکند که شما می‌توانید، نه بیشتر. کد منبع برای خواندن و بررسی شما باز است. به هر کانکتور یک کلید مخصوص با محدودیت IP بدهید (API-03).

#CON-05
CON-06 کانکتور چه چیزهایی می‌تواند بفروشد؟

لاین‌ها (ساخت، تمدید، تغییر پکیج، تعلیق، حذف) و حساب‌های زیرریسلر همراه با کردیت.

#CON-06
CON-07 هنوز برای پلتفرم من کانکتوری وجود ندارد؟

خودتان با Reseller API (API-01) و وب‌هوک‌ها یکپارچه کنید، یا از راه کانال پشتیبانی درخواست بفرستید.

#CON-07

داده‌ها، حذف و حریم خصوصی

DATA
DATA-01 آیا لاین حذف‌شده قابل بازیابی است؟

خیر. حذف‌شده یعنی از بین رفته: مشخصات لاین (نام کاربری، رمز عبور، تماس، یادداشت‌ها)، تاریخچه اتصال آن (IPها، دستگاه‌ها، آنچه تماشا شد)، ست‌تاپ‌باکس‌های وصل به لاین و کد فعال‌سازی آن. سطل بازیافت، قابلیت بازیابی یا API بازیابی وجود ندارد. وقتی مشتری برگشت، لاین جدیدی بسازید.

#DATA-01
DATA-02 پس از حذف، سیستم چه چیزی نگه می‌دارد؟

فقط یک رکورد آماریناشناسبرای اپراتور (مشتری جدید یا برگشتی، کدام پکیج‌ها محبوب‌اند). هیچ چیز قابل خواندنی درباره مشتری ندارد و هیچ ریسلر، کانکتور یا API به آن دسترسی ندارد.

#DATA-02
DATA-03 آیا بکاپ می‌تواند لاین حذف‌شده را برگرداند؟

خیر. بکاپ‌های پایگاه داده فقط برای بازسازی سیستم پس از یک حادثه وجود دارند و نزد اپراتور هستند؛ برای لغو یک حذف استفاده نمی‌شوند. بکاپ‌های قدیمی چرخانده و حذف می‌شوند، پس داده حذف‌شده از آن‌ها هم محو می‌شود.

#DATA-03
DATA-04 چرا رمز عبور لاین قابل خواندن است ولی رمز عبور پنل نه؟

رمز عبور لاین باید در برنامه‌ها تایپ شود و بخشی از لینک پلی‌لیست است، پس پنل آن را برای مالک لاین خوانا نگه می‌دارد. رمزهای حساب‌های پنل فقط به‌صورت هش ذخیره می‌شوند.

#DATA-04
DATA-05 چه کسانی لاین‌ها و مشتریان من را می‌بینند؟

شما، حساب‌های بالادستی شما در درخت، و ادمین. ریسلرهای دیگر و سطوح زیر شما نمی‌بینند.

#DATA-05
DATA-06 آیا پنل برای مشتریان من ایمیل / پیام می‌فرستد؟

هرگز. مشتریان یک لاین متعلق به ریسلر هستند؛ شما از طریق سیستم خودتان با آن‌ها تماس می‌گیرید.

#DATA-06
DATA-07 آیا پیش از انقضای یک لاین به من خبر داده می‌شود؟

به دو شکل: یک ایمیل خلاصه روزانه از لاین‌های نزدیک به انقضا (اگر ادمین فعال کرده باشد؛ به‌طور پیش‌فرض ۳ روز قبل)، و وب‌هوک‌هایline.expiring/line.expiredبرای سیستم شما.

#DATA-07

عیب‌یابی

FIX

از بالا به پایین بررسی کنید. بیشتر مشکلات «نمی‌توانم تماشا کنم» در ۵ ردیف اول هستند.

FIX-01 مشتری نمی‌تواند وارد شود / نمی‌تواند تماشا کند بیننده
#CheckSignWhat to do
1نام کاربری / رمز عبوربرنامه مشخصات نادرست گزارش می‌دهدبا فرم لاین مقایسه کنید (حساس به حروف بزرگ و کوچک، بدون فاصله)؛ لینکGenerate play linkرا دوباره بفرستید
2انقضابرنامهExpiredگزارش می‌دهدتمدید کنید (LINE-06)
3وضعیتDisabled/Bannedدوباره فعال کنید؛ برایBannedبا ادمین تماس بگیرید
4آدرس سروراتصال برقرار نمی‌شوداز آدرس و پورت دقیق لینک پخش وhttp/httpsدرست استفاده کنید
5تعداد اتصالوقتی کس دیگری شروع به تماشا می‌کند بیرون انداخته می‌شودSEC-01,SEC-02
6IP مسدودهیچ لاینی از آن شبکه وارد نمی‌شودSEC-08: صبر کنید تا مسدودسازی برداشته شود یا از ادمین بخواهید بردارد
7قفل ISP / کشور / Allowed IPsفقط پس از تغییر شبکه، با داده موبایل، با VPN یا در سفر خراب می‌شودSEC-04,SEC-05,SEC-07
8فرمتلینک HLS / TS رد می‌شوداز فرمتی استفاده کنید که پکیج مجاز کرده (PLAY-03)
9برنامه مسدودفقط در یک برنامه خراب می‌شودبرنامه دیگری امتحان کنید؛SEC-09
#FIX-01
FIX-02 ورود کار می‌کند و فهرست نمایش داده می‌شود، اما یک کانال پخش نمی‌شود بیننده

معمولاً یکی از قفل‌های پخش (ردیف‌های ۵ تا ۹ درFIX-01): ورود و فهرست کانال‌ها IP / برنامه را بررسی نمی‌کنند، فقط پخش بررسی می‌کند. اگر فقطیککانال روی همه لاین‌ها خراب است → کانال منبع مشکل دارد؛ نام کانال و زمان را به ادمین بگویید.

#FIX-02
FIX-03 کانال‌ها یا گروه‌های کانال ناپدید شده‌اند بیننده

بوکه‌های لاین (PKG-04,PKG-05) و قالب دسته‌بندی اختصاص‌یافته به آن (CAT-02) را بررسی کنید. پس از تغییر، از مشتری بخواهید فهرست را در برنامه دوباره بارگذاری کند. کانالی که ادمین همین الان اضافه کرده بعد از حدود نیم دقیقه ظاهر می‌شود؛ اگر کانالی در بوکه هست و هیچ لاینی آن را نمی‌بیند، ممکن است ادمین آن کانال را از پخش خارج کرده باشد.

#FIX-03
FIX-04 پرش و قفل شدن تصویر بیننده

به ترتیب امتحان کنید: کانال دیگر (یک کانال یا همه؟) → شبکه دیگر → فرمت دیگر (HLS به‌جای MPEG-TS) → برنامه دیگر. همه کانال‌ها روی همه شبکه‌ها خراب است → نام کاربری، زمان و کانال را به پشتیبانی بگویید.

#FIX-04
FIX-05 راهنمای برنامه (EPG) نیست بیننده

برنامه M3U نیاز دارد لینک XMLTV اضافه شود (PLAY-05). کانالی که در منبع EPG ندارد برنامه‌ای نشان نمی‌دهد.

#FIX-05
FIX-06 نمی‌توانم لاین بسازم

به ترتیب: پکیجی انتخاب نشده · پکیج برای گروه شما نیست (PKG-02) · کردیت کافی نیست (CRD-05) · نام کاربری گرفته شده یا کوتاه‌تر از حداقل است (LINE-02) · سهمیه تریال تمام شده (TRI-01).

#FIX-06
FIX-07 دانلود پلی‌لیست خطای 429 یا صفحه 404 برمی‌گرداند

429: لاین همزمان پلی‌لیست / فایل EPG زیادی دانلود می‌کند — صبر کنید و دوباره تلاش کنید. صفحه 404: سیستم برایهررد شدن (مشخصات نادرست، منقضی، قفل، فراتر از محدودیت) 404 جواب می‌دهد تا دلیل برای غریبه‌ها فاش نشود؛ باFIX-01بررسی کنید.

#FIX-07
FIX-08 نمی‌توانم یک صفحه داشبورد را باز کنم

گروه شما برای آن صفحه مجوز ندارد (ACC-02).Live Connectionsعلاوه بر آن نیاز دارد ادمین گزینه دیدن اتصالات مشتریان را برای گروه روشن کرده باشد (LINE-15).

#FIX-08
FIX-09 ایمیلی از پنل دریافت نمی‌کنم

ایمیل فقط وقتی ارسال می‌شود که ادمین سرور ایمیل را پیکربندی و آن نوع پیام را فعال کرده باشد؛ حساب باید آدرس ایمیل واقعی داشته باشد. پوشه اسپم را بررسی کنید.

#FIX-09

واژه‌نامه

Line (لاین)
اشتراک IPTV یک بیننده: نام کاربری، رمز عبور، انقضا، بوکه‌ها، محدودیت‌ها
User (کاربر)
حسابی که وارد پنل می‌شود: ادمین، ریسلر، زیرریسلر
Group (گروه)
گروه مجوز یک حساب پنل؛ منوها، پکیج‌های قابل فروش، قوانین لاین و تریال را تعیین می‌کند
Bouquet (بوکه)
فهرستی از محتوا (کانال‌ها، فیلم‌ها، سریال‌ها)
Package (پکیج)
محصولی که فروخته می‌شود: بوکه‌ها + مدت + محدودیت‌ها + قیمت به کردیت
Credit (کردیت)
واحد پیش‌پرداخت برای خرید پکیج‌ها
Trial (تریال)
دوره آزمایشی یک پکیج
Activation code (کد فعال‌سازی)
کدی که مشتری با آن خودش یک لاین پولی را فعال می‌کند
MAG / Enigma2
دو خانواده ست‌تاپ‌باکس؛ با آدرس MAC وارد می‌شوند
Xtream Codes API
پروتکلی که بیشتر برنامه‌های IPTV استفاده می‌کنند (سرور + نام کاربری + رمز عبور)
M3U / XMLTV
فرمت فایل پلی‌لیست / راهنمای برنامه
MPEG-TS / HLS
دو فرمت استریم
EPG
راهنمای برنامه‌ها
Catch-up
تماشای یک برنامه پس از پخش آن
Restreamer (ریستریمر)
لاینی برای یک شریک که استریم‌ها را می‌کشد تا دوباره توزیع کند
Connector (کانکتور)
نرم‌افزاری که سیستم فروشگاه ریسلر را به پنل وصل می‌کند
Webhook (وب‌هوک)
اعلانی که پنل وقتی اتفاقی می‌افتد به سیستم ریسلر می‌فرستد

هنوز مشکل دارید؟

نام کاربری لاین (هرگز رمز عبور آن را نه)، زمان وقوع مشکل، برنامه یا دستگاه، و کد پرسشی را که قبلاً امتحان کرده‌اید ارسال کنید.