الرئيسية
Xtream UIPro

مركز المساعدة

الأسئلة والأجوبة

كيف تعمل الأرصدة والباقات والخطوط وروابط التشغيل والأجهزة — وماذا تفحص عندما لا يعمل البث.

139 من 139 سؤالاً

هل هناك ما لا يعمل؟ تُحل معظم المشكلات بقائمة الفحص في قسم حل المشكلات. ابدأ منها. فتح حل المشكلات

كيف تستخدم هذه الصفحة

لكل سؤال رمز ثابت (مثلLINE-07). اذكره عند التواصل مع الدعم، أو انسخ رابط السؤال.

أسماء القوائم والأزرار والحقول مكتوبة كما تعرضها اللوحة.المستخدمهو حساب يسجّل الدخول إلى اللوحة (مدير، موزّع)؛ والخطهو اشتراك IPTV الخاص بالمشاهد. لا يُخلط بينهما أبداً.

  • المشاهد يمكن للموزّع إرسال هذه الإجابة إلى المشاهد كما هي
  • المدير لمشغّل اللوحة

نظرة عامة على الخدمة ومن المسؤول عن ماذا

GEN
GEN-01 ماذا تقدّم هذه الخدمة؟

نظام OTT / IPTV متكامل: لوحة الإدارة (dashboard)، وخادم API لتطبيقات المشاهدين، وتوصيل القنوات المباشرة والأفلام والمسلسلات والراديو، ومشغّل ويب. نحن نوفّر النظام ونصونه، ويستخدمه الموزعون لمنح عملائهم حق المشاهدة (الخطوط).

#GEN-01
GEN-02 ما الذي لا تفعله الخدمة؟
  • لا تحصّل الأموال نيابةً عنك وليس فيها بوابة دفع. سعر عملائك وطريقة قبض أموالك والفوترة من شأن الموزّع (انظرCON-01).
  • لا تتواصل مع مشاهدي الموزّع. ترسل اللوحة البريد الإلكتروني إلى حسابات اللوحة فقط، ولا ترسله إلى أي خط.
  • لا تحتفظ بالبيانات الشخصية لعميل محذوف وليس فيها وظيفة استعادة (انظرDATA-01).
#GEN-02
GEN-03 من هو من في النظام؟
الدورمن هوأين يسجّل الدخول
المدير (Admin)مشغّل اللوحةdashboard
الموزّع (Reseller)يبيع الخطوط؛ يتلقى أرصدة من المديرdashboard، Reseller API
الموزّع الفرعي (Sub-reseller)موزّع أُنشئ تحت موزّع آخرdashboard، Reseller API
الخط (Line)مشترك — المشاهد النهائيتطبيق IPTV، جهاز استقبال، مشغّل الويب.أبداًdashboard
#GEN-03
GEN-04 ما الخطوات التي توصل القناة إلى المشاهد؟
  1. ينشئ المدير الفهرس (قنوات، أفلام، مسلسلات، راديو) ويجمعه فيباقات قنوات (bouquets).
  2. ينشئ المديرباقة (package): باقات القنوات + المدة + عدد الاتصالات + السعر بالأرصدة.
  3. يصرف الموزّع أرصدة لبيع الباقة ← ينشئ النظامخطاً.
  4. يُدخل العميل بيانات الخط في تطبيق؛ يفحص النظام الخط (غير منتهٍ، مفعّل، ضمن حدوده) ويبثّ من خادم مناسب.
#GEN-04
GEN-05 ماذا يستطيع الموزّع أن يفعل بالمحتوى وماذا لا يستطيع؟

يستطيع الموزّععرضقوائم القنوات والأفلام والمسلسلات والراديو وباقات القنوات والباقات (عندما تملك مجموعته الصلاحية)، لكنه لا يستطيع إضافة المحتوى أو تعديله أو حذفه. المحتوى والباقات يديرها المدير. يحدد الموزّع ما يشاهده كل عميل باختيار الباقة (وباقات القنوات عندما تسمح المجموعة بذلك —PKG-05).

#GEN-05
GEN-06 أين أحصل على الدعم؟

بندSupportفي الشريط الجانبي يفتح موقع الدعم المستقل. ليس في اللوحة نظام تذاكر خاص بها. عند إرسال طلبك أرفق: اسم مستخدم الخط (وليس كلمة المرور أبداً)، ووقت حدوث المشكلة، والتطبيق / الجهاز، ورمز السؤال من هذه الصفحة إن كنت جرّبته.

#GEN-06
GEN-07 ما اللغات التي تتوفر بها الواجهة؟

في اللوحة ومشغّل الويب وصفحة المساعدة هذه مبدّل لغات يضم 27 لغة. الإنجليزية والفيتنامية هما الترجمتان المرجعيتان؛ وفي اللغات الأخرى قد تبقى الشاشة المضافة حديثاً بالإنجليزية لبعض الوقت. البريد الذي ترسله اللوحة بالإنجليزية فقط حالياً.

#GEN-07

حسابات اللوحة وتسجيل الدخول

ACC
ACC-01 لماذا لا يستطيع عميلي تسجيل الدخول إلى dashboard؟

هذا بالتصميم: الخط ليس حساب لوحة. يستخدم العميل بيانات الخط فقط في تطبيق IPTV أو جهاز استقبال أو مشغّل الويب. وبالعكس، لا يمكن استخدام حساب الموزّع لمشاهدة القنوات.

#ACC-01
ACC-02 أرى قوائم أقل مما تصفه هذه الصفحة. لماذا؟

تعتمد القوائم والإجراءات علىالمجموعةالتي منحها المدير لحسابك. الصفحة التي لا تملك مجموعتك صلاحيتها لا تظهر في الشريط الجانبي ولا يمكن فتحها. اطلب من المدير مزيداً من الصلاحيات.

#ACC-02
ACC-03 أين أغيّر كلمة مرور اللوحة؟

في منطقة الحساب (الملف الشخصي ← تغيير كلمة المرور). تُخزَّن كلمات مرور اللوحة مشفّرة بالتجزئة؛ لا أحد يستطيع قراءتها — ولا حتى المدير. إن نسيتها فاطلب من الحساب الأعلى منك (الموزّع الأب أو المدير) تعيين كلمة جديدة.

#ACC-03
ACC-04 لماذا يتم تسجيل خروجي عند تغيير الشبكة؟

يمكن ضبط اللوحة لإنهاء الجلسة عند تغيّر عنوان IP، حتى لا يمكن إعادة استخدام جلسة مسروقة. سجّل الدخول مجدداً. هذا إعداد يتحكم فيه المدير.

#ACC-04
ACC-05 ماذا يحدث بعد عدة محاولات تسجيل دخول خاطئة؟

تحدّ اللوحة من محاولات تسجيل الدخول الفاشلة (يضبطها المدير). بعد تجاوز الحد عليك الانتظار قبل المحاولة مجدداً.

#ACC-05
ACC-06 بماذا يختلف الحساب التجريبي (demo) عن الحساب الحقيقي؟

الحساب التجريبي يعرض الواجهة فقط: لا يمكنه تغيير كلمة مروره أو تعديل ملفه الشخصي أو إنشاء رموز تفعيل أو فعل أي شيء لا يمكن التراجع عنه.

#ACC-06
ACC-07 حسابي «معطّل». ماذا يعني ذلك؟

الحساب الأعلى منك أوقفه: لا يمكنك تسجيل الدخول إلى اللوحة ويتم رفض مفاتيح API الخاصة بك. الخطوط المباعة سابقاً لا تُحذف. تواصل مع الحساب الأعلى منك.

#ACC-07
ACC-08 أين أراجع ما فعلته أنا وموزعيّ الفرعيون؟

Logs → Reseller Logs(عندما يسمح للمجموعة بعرض السجلات): كل خط أو جهاز أُنشئ أو عُدّل أو جُدّد أو فُعّل / عُطّل أو حُذف، وكل موزّع فرعي أُنشئ، وكل تحويل رصيد — مع الأرصدة المخصومة. ترى فقط سجلاتك وسجلات الحسابات التي تحتك؛ ولا يمكن حذف السجل (للمدير فقط). يبقى سجل الأرصدة (CRD) هو المكان لمطابقة الرصيد.

#ACC-08

الأرصدة

CRD
CRD-01 ما هو الرصيد (credit)؟

وحدة الدفع المسبق في اللوحة. كل عملية بيع (إنشاء خط، تجديد، إنشاء رموز تفعيل، إنشاء موزّع فرعي) تخصم أرصدة وفق سعر الباقة أو رسوم المجموعة. الرصيد ليس مالاً ولا تحوّله اللوحة: قيمة الرصيد الواحد يُتفق عليها بينك وبين الحساب الأعلى منك.

#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 هل أستطيع استرجاع الأرصدة التي حوّلتها إلى موزّع فرعي؟

نعم: في نموذج تعديل الموزّع الفرعي، أدخل رقماً سالباً في حقل تحويل الرصيد. لا يمكن لأي رصيد أن ينزل عن 0.

#CRD-08
CRD-09 كيف أعرف مسبقاً كم خطاً أستطيع شراءه؟

يعرض محدّد الباقة في نموذج الخط سعرك الخاص. عبر API يعيد الإجراءpricingرصيدك وسعر كل باقة وكم يمكنك تحمّله.

#CRD-09

الباقات وباقات القنوات والأسعار

PKG
PKG-01 ما الفرق بين باقة القنوات (bouquet) والباقة (package)؟

باقة القنوات (bouquet)قائمة محتوى (قنوات، أفلام، مسلسلات). أماالباقة (package)فهي المنتج الذي تبيعه: باقة قنوات أو أكثر، ومدة، وعدد اتصالات، وصيغ إخراج، وأقفال، وسعر بالأرصدة (السعر الرسمي وسعر التجربة).

#PKG-01
PKG-02 لماذا لا أرى باقة معينة؟

لا يمكن بيع الباقة إلا من المجموعات التي اختارها المدير لها. الباقة غير المخصصة لمجموعتك لا تظهر في المحدّد ويتم رفضها عند إرسالها عبر API.

#PKG-02
PKG-03 سعري يختلف عن سعر الباقة. لماذا؟

يستطيع المدير تحديدسعر خاصلكل موزّع ولكل باقة (0 = مجاني). يسري السعر الخاص على إنشاء خط رسمي والتجديد ورموز التفعيل الرسمية؛ ولا يسري على التجارب.

#PKG-03
PKG-04 عندما يغيّر المدير باقات القنوات في باقة، هل تتغير الخطوط المباعة سابقاً؟

لا. تُنسخ باقات القنواتإلى الخطوقت البيع؛ وتعديل الباقة لاحقاً لا يؤثر على الخطوط المباعة. يحصل الخط على باقات القنوات الجديدة للباقة عند تجديده / تغيير باقته التالي. (أما عندما يتغير المحتوىداخلباقة قنوات، فكل خط يملكها يراه فوراً. حذف باقة قنوات يزيل معرّفها من كل خط وباقة. وتغيير الترتيب العام لباقات القنوات لا يغيّر الترتيب المخزّن في الخطوط المباعة إلا إذا حدّدت خانة «تطبيق على الخطوط والباقات المباعة»؛ أما مجموعة باقات القنوات في الخط فلا تتغير.)

#PKG-04
PKG-05 هل أستطيع بيع جزء فقط من الباقة؟

فقط عندما يكون خيارAllow Bouquet Selectionمفعّلاً في مجموعتك: تحدّد جزءاً من باقات قنوات الباقة؛ عدم تحديد شيء = الباقة كاملة؛ وأي باقات قنوات خارج الباقة تُسقَط. السعر لا يتغير.

#PKG-05
PKG-06 أي خصائص الخط تحددها الباقة؟

تاريخ الانتهاء (اليوم + مدة الباقة)، وعدد الاتصالات، وصيغ الإخراج، وrestreamer، وقفل الجهاز، والدولة المفروضة، والخادم المفروض، وقفل ISP، وباقات القنوات. القيم التي يدخلها الموزّع لهذه الحقول تُتجاهل، باستثناء باقات القنوات (PKG-05) وقفل ISP عندما يكون خيارAllow Line Restrictionsمفعّلاً في المجموعة.

#PKG-06
PKG-07 ما هي باقة «MAG only» / «Enigma only»؟

باقة لا يمكن بيعها إلا لذلك النوع من أجهزة الاستقبال؛ ولا يمكن بيعها لخط عادي أو لنوع الجهاز الآخر. وبالمقابل، يجب أن تسمح الباقة بنوع الجهاز قبل استخدامها في نموذج Add MAG / Add Enigma.

#PKG-07

الخطوط: الإنشاء والتعديل والتجديد والحذف

LINE
LINE-01 ماذا أحتاج لإنشاء خط؟

يجب أن تختار باقة يحق لمجموعتك بيعها وأن يكون لديك رصيد كافٍ. اسم المستخدم / كلمة المرور: اكتب ما تريد (عندما تسمح المجموعة) أو اتركهما فارغين ليُولَّدا تلقائياً. وقد يترك المدير أحدهما (أو كليهما) فارغاً عند إنشاء خط: يولّد النظام 10 أحرف ويعرضها فور الحفظ؛ أما نموذجالتعديلفيتطلب اسم مستخدم.

#LINE-01
LINE-02 لماذا لا أستطيع اختيار اسم المستخدم / كلمة المرور بنفسي؟

خيارAllow Username Change/Allow Password Changeمعطّل في مجموعتك: الخط الجديد يحصل على قيم مولَّدة. وعندما يحق لك كتابة قيمك، تحدد المجموعة الحد الأدنى للطول (8 أحرف افتراضياً).

#LINE-02
LINE-03 أين أرى كلمة مرور الخط مجدداً؟

في نموذج تعديل الخط وفي نافذةGenerate play linkفي قائمة Lines. تُحفظ كلمات مرور الخطوط بشكل مقروء لأن تطبيقات IPTV وروابط قوائم التشغيل تحتاجها. وتُعرض كلمة المرور المولَّدة فور الحفظ.

#LINE-03
LINE-04 خط قديم لا تظهر له كلمة مرور والعميل لا يستطيع تسجيل الدخول؟

بعض الخطوط التي أنشأها إصدار سابق من اللوحة لا تحمل سوى كلمة مرور مشفّرة بالتجزئة. مثل هذا الخطلا يستطيع تسجيل الدخولولا تعرض اللوحة له كلمة مرور. عيّن كلمة مرور جديدة في نموذج تعديل الخط وأرسلها إلى العميل.

#LINE-04
LINE-05 ماذا يستطيع الموزّع تعديله في الخط بعد البيع؟

التفعيل / التعطيل، وملاحظات الموزّع، وجهة الاتصال، وقالب الفئات، والمالك (ضمن شجرتك)؛ واسم المستخدم وكلمة المرور عندما تسمح المجموعة؛ والقيود (عناوين IP وuser agents وقفل ISP) عندما يكون خيارAllow Line Restrictionsمفعّلاً في المجموعة؛ واختيار جديد لباقات القنوات ضمن الباقة عندما تسمح المجموعة. أما الباقة وتاريخ الانتهاء وعدد الاتصالات وعلامة التجربة وصيغ الإخراج وقفل الجهاز والدولة فلا يمكن تعديلهامباشرة— بل تتغير فقط عبر التجديد / تغيير الباقة.

#LINE-05
LINE-06 كيف أجدّد خطاً؟

طريقتان بقاعدة واحدة:

  • زرRenew (charged)في القائمة: يستخدم الباقة الحالية للخط؛
  • حقلExtend with packageفي نموذج التعديل: اختر أي باقة يحق لك بيعها (وهكذا أيضاًتغيّر الباقة).

عندما تعدّل خطاً وتختار تجديداً في عملية الحفظ نفسها، فهمامعاملة واحدة: إذا رُفض التجديد (رصيد غير كافٍ، باقة غير قابلة للبيع) فلن يُحفظ التعديل أيضاً ولن يُخصم أي رصيد. صحّح ثم احفظ مجدداً.

#LINE-06
LINE-07 هل يُحتفظ بالوقت المتبقي عند التجديد؟
  • الخطلم ينتهِوالباقة الجديدةمتوافقةمع القديمة ← يُضاف الوقت إلى تاريخ الانتهاء الحالي.
  • الخطمنتهٍ، أو الباقتان غير متوافقتين ← يُحتسب من اليوم؛ ولا يُحتفظ بأي وقت متبقٍ.

«التوافق» يُفحص فقط عندما يكون خيار فحص التوافق مفعّلاً في الباقة الجديدة: يجب أن تتطابق في الباقتين باقات القنوات وصيغ الإخراج وعدد الاتصالات وعلامة restreamer وقفل الجهاز. وعند تعطيل الخيار تُعد الباقتان متوافقتين دائماً. الباقات الجديدة يكون الخيار مفعّلاً فيها افتراضياً (يستطيع المدير تعطيله)؛ والباقات الحالية تحتفظ بإعدادها. لا يمكن تجديد خط MAG / Enigma إلا بباقة تسمح بذلك النوع من الأجهزة، أو التحويل إليها.

#LINE-07
LINE-08 كيف يُحتسب تغيير الباقة (ترقية / تخفيض)؟

تغيير الباقة = شراء فترة رسمية واحدة من الباقة الجديدة: يُخصم السعر الكامل للباقة الجديدة (سعرك الخاص إن وُجد)، دون احتساب أي رصيد عن الجزء غير المستخدم. يتخذ الخط كل خصائص الباقة الجديدة.

#LINE-08
LINE-09 ما الفرق بين تعطيل الخط وحذفه؟

التعطيل: لا يستطيع العميل تسجيل الدخول أو المشاهدة، وتُغلق الجلسات الجارية خلال دقيقة تقريباً؛ وتستمر مدة الاشتراك بالجريان؛ ويمكنك تفعيله مجدداً في أي وقت.الحذف: دائم، بلا استعادة وبلا استرداد (DATA-01). للعميل الذي يتوقف مؤقتاً، عطّل — لا تحذف.

#LINE-09
LINE-10 ماذا تعني حالات الخط؟
الحالةالمعنىمن يستطيع رفعها
Activeقابل للاستخدام—
Disabledأوقفه الموزّع / المالكالموزّع
Bannedقفله المديرالمدير فقط
Expiredتجاوز تاريخ انتهائهالتجديد
Trialخط تجريبي، صالح حتى انتهاء فترة التجربةيصبح رسمياً عند التجديد
#LINE-10
LINE-11 ماذا يحدث عندما ينتهي الخط؟

يُرفض العميل إلى أن يُجدَّد الخط (الخط المنتهي والمحظور معاً يرى مقطع «منتهي» لأن الانتهاء يُفحص أولاً)؛ وتُغلق الجلسات الجارية خلال دقيقة تقريباً. الخطلا يُحذفتلقائياً: جدّده فيعمل مجدداً بنفس اسم المستخدم / كلمة المرور.

#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 على أي نافذة تُحتسب حصة التجارب؟

كما هو مضبوط في المجموعة:يوم= آخر 24 ساعة،شهر= آخر 30 يوماً. مثال: حصة 5 / يوم: 5 خطوط تجريبية كحد أقصى في أي 24 ساعة. التجربة الأقدم تحرّر خانتها عندما تخرج من النافذة.

#TRI-02
TRI-03 هل تكلّف التجربة أرصدة؟

بالضبط سعر تجربة الباقة (عادةً 0). السعر الخاص بالموزّع لا يسري على التجارب.

#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تستخدم البوابة (portal)، وأجهزةEnigma2تستخدم قائمة تشغيل / إضافة. وبدون أي جهاز، استخدممشغّل الويبفي المتصفح.

#PLAY-02
PLAY-03 MPEG-TS أم HLS؟

MPEG-TS: تبديل سريع بين القنوات، ويناسب تطبيقات IPTV وأجهزة الاستقبال.HLS: يعمل جيداً في المتصفحات وعلى أجهزة Apple وعلى الشبكات غير المستقرة. لا يستطيع الخط استخدام إلا الصيغ التي تسمح بها باقته؛ ويُرفض الرابط بصيغة غير مسموح بها.

#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 العميل لديه خط بالفعل ويريد إضافة جهاز؟

في نموذج الجهاز، اخترالخط الموجودللعميل بدلاً من الباقة: يُقرَن الجهاز بذلك الخط(paired)مجاناً. يواصل العميل استخدام الخط في التطبيق؛ ويتبع الجهاز باقة الخط وانتهاءه وباقات قنواته وحالته.

#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: اختر الباقة، والكمية (1–500 في الدفعة)، وطول الرمز (6–24)، وخيار الأرقام فقط (سهل الإدخال بريموت التلفاز)، وخيار التجربة. تُخصم الأرصدةعند الإنشاء= سعر الباقة × عدد الرموز. يأتي كل رمز مع خط خاص به، مقفل حتى التفعيل.

#CODE-02
CODE-03 ما الأحرف التي يتضمنها الرمز؟

أحرف كبيرة وأرقام دون الأحرف التي يسهل الخلط بينها (0 وO و1 وI)؛ أو أرقام فقط. ويُقبل الرمز إذا كتبه العميل بأحرف صغيرة.

#CODE-03
CODE-04 على كم جهاز يمكن استخدام رمز واحد؟ المشاهد

جهاز واحد. يرتبط الرمز بأول جهاز يفعّله؛ ويُرفض جهاز آخر يُدخل الرمز نفسه. يستطيع ذلك الجهاز إدخال الرمز كما يشاء، ولا تتغير بيانات دخول الخط.

#CODE-04
CODE-05 ماذا لو غيّر العميل جهازه؟

Reset deviceعلى ذلك الرمز؛ ثم يستطيع الجهاز الجديد تفعيله. لا يُضاف أي وقت إلى المدة.

#CODE-05
CODE-06 يظهر للعميل خطأ عند إدخال الرمز. ماذا يعني؟ المشاهد
الرسالةالمعنىما العمل
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 هل يتبع خط رمز التفعيل حدود الباقة؟

نعم، مثل كل خط يُباع بتلك الباقة: عدد الاتصالات، وصيغ الإخراج، وباقات القنوات، وقفل الجهاز، وrestreamer، وكذلكالدولة المفروضةللباقة (SEC-07). العميل الذي يفعّل رمزاً من دولة خارج القائمة المسموح بها يستطيع التفعيل لكن يُرفض عند التشغيل.

#CODE-10

حدود الاتصال وأقفال حماية الخط

SEC
SEC-01 كيف يُحتسب «Max connections»؟

هو عدد الأجهزة التي تشاهدفي الوقت نفسهبخط واحد. 0 = غير محدود. إعادة فتح القناة التي تشاهدها بالفعل من الجهاز نفسه لا تُحتسب اتصالاً آخر.

#SEC-01
SEC-02 من يُفصل عند تجاوز الحد؟ المشاهد

افتراضياً: يدخل الاتصالالجديدويُغلقأقدماتصال (مع تفضيل اتصال من الجهاز نفسه، ثم من عنوان IP نفسه). يتوقف المشغّل المغلق خلال نحو 30 ثانية. يستطيع المدير التحويل إلىرفض الاتصال الجديدبدلاً من إغلاق قديم.

#SEC-02
SEC-03 ما قاعدة «عنوان IP الثاني»؟

عندما يفعّلها المدير: أثناء مشاهدة الخط من عنوان IP واحد، يُرفض اتصال مباشر من عنوان IP آخر. يمكن حصر القاعدة بالخطوط ذات الاتصالات القليلة (مثلاً الخطوط ذات اتصال واحد؛ والخط ذو الاتصالات غير المحدودة لا يُقيَّد إلا إذا كان الحد 0). مع تفعيل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 واحد بأسماء مستخدمين / رموز تفعيل كثيرة مختلفة في وقت قصير، أو سيل من الطلبات. يزول الحظر التلقائي بنفسه بعد المدة التي ضبطها المدير (60 دقيقة افتراضياً).
  • يدوياً: حظر المدير عنوان IP / نطاق IP؛ ولا ينتهي هذا.

طالما أن عنوان IP محظور، لا يستطيعأيخط الاتصال منه. تكرار الخطأ في كتابة اسم المستخدم نفسه لا يسبب حظراً.

#SEC-08
SEC-09 ما الأسباب الأخرى التي قد تُحظر بها الاتصالات؟

يستطيع المدير الحظر حسبUser-Agent(التطبيق)، وحسبمزوّد الإنترنت (ISP)، وحسبASN(مثل نطاقات الاستضافة / VPN). الخط الذي فعّل له المدير «bypass UA» يتجاوز قائمة حظر التطبيقات.

#SEC-09
SEC-10 ما هو restreamer؟

خط لشريك يسحب البثوث لإعادة توزيعها. وهو معفى من حد الاتصالات وقاعدة عنوان IP الثاني والإنهاء التلقائي للجلسات الطويلة وحظر ASN. تحدده الباقة / المدير؛ وليس مخصصاً للمشاهدين العاديين.

#SEC-10
SEC-11 هل تُقطع الجلسة المتواصلة الطويلة جداً؟ المشاهد

يستطيع المدير تحديد مدة قصوى للجلسة المتواصلة؛ وبعدها تُغلق الجلسة ويضغط العميل تشغيل للمتابعة. والجلسة التي تفقد إشارتها نحو 90 ثانية تُعد مغلقة أيضاً.

#SEC-11
SEC-12 كيف أكتشف خطاً مشتركاً أو مسروقاً؟
  • صفحةTheft Detection(عندما تملك المجموعة الصلاحية): ترتّب الخطوط حسب عدد الأفلام / الحلقاتالمختلفةالتي شوهدت خلال ساعة / 24 ساعة / 7 أيام، مع عدد عناوين IP المختلفة — الخط المرتفع بشكل غير معتاد مشبوه.
  • صفحة نشاط الخط: تعرض عناوين IP والأجهزة المستخدمة.
  • ما العمل: غيّر كلمة مرور الخط (PLAY-08)، وفعّل تقييد IP / قفل ISP، أو عطّل الخط.
#SEC-12

الموزعون الفرعيون

SUB
SUB-01 هل أستطيع إنشاء موزعين فرعيين؟

عندما يكون خيارCan Create Sub-Resellersمفعّلاً في مجموعتك ومجموعة واحدة على الأقل فيGroups for sub-resellers. كل عملية إنشاء تخصم رسم الإنشاء (بالأرصدة) المضبوط في المجموعة. عمق شجرة الموزعين 5 مستويات كحد أقصى.

#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 أي القوالب أستطيع رؤيتها وتعديلها؟

الرؤية: قوالبك وقوالب الحسابات التي تحتك، وقوالب النظام، والقوالب التي تشاركها المستويات الأعلى. التعديل: قوالبك والقوالب التي تحتك فقط. لتعديل قالب نظام،كرّره (duplicate)وعدّل النسخة.

#CAT-04
CAT-05 حدود تستحق المعرفة؟

الترتيب المخصص للفئات لا يسري على جزء الأفلام / المسلسلات في قائمة تشغيل M3U (يظل الإخفاء والأسماء ساريين). التطبيقات التي تستخدم Xtream API تحصل على كل شيء.

#CAT-05

Reseller API ومفاتيح API وWebhooks

API
API-01 ما فائدة Reseller API؟

لنظامك الخاص (متجر ويب، فوترة، بوت) ليبيع ويدير الخطوط / الموزعين الفرعيين دون فتح dashboard. العنوان:{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 أن يفعل؟
الحاجةالإجراء
الرصيد والأسعار وكم تستطيع تحمّله وقواعد اسم المستخدم / التجربة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
رموز التفعيلإنشاء، سرد، تفعيل / تعطيل، إعادة ضبط الجهاز، حذف
Webhooks والعنوان الخاص للتشغيل وسجل استدعاءات APIcreate_webhook…,set_play_base,api_logs

تسري كل قواعد dashboard (المجموعة، السعر الخاص، حصة التجارب، نطاق الشجرة) عبر API بالطريقة نفسها تماماً.

#API-04
API-05 إذا أعدت المحاولة بعد خطأ في الشبكة، هل يُخصم مني مرتين؟

لا، ما دمت ترسلrequest_idنفسه للمعاملة نفسها: يعيد النظام النتيجة السابقة. وrequest_idالخاص بالتجديدمرتبط بذلك الخط: إعادة استخدامه لخط آخر تعيد خطأ تعارض (HTTP 409) ولا يتغير الخط الآخر — أنشئrequest_idجديداً لكل معاملة.

#API-05
API-06 التكامل الخاص بي لا يعمل. كيف أفحصه بنفسي؟

في صفحة API Key جدولاستدعاءات API الأخيرة(30 يوماً): الإجراء، والنتيجة، ورمز الخطأ، وعنوان المستدعي، واسم الموصّل (connector). لا تُسجَّل المعاملات (parameters) أبداً.

#API-06
API-07 ما هو webhook وما الأحداث المتوفرة؟

تُخبر اللوحة نظامك عند حدوث شيء، فلا تضطر للسؤال باستمرار. الأحداث:line.created,line.renewed,line.enabled,line.disabled,line.deleted,line.expiring(قبل 3 أيام),line.expired,credits.low(دون العتبة التي تحددها). يجب أن يكون عنوان الاستقبال https ويمكن الوصول إليه من الإنترنت.

#API-07
API-08 كيف أعرف أن webhook أصلي؟

يحمل كل إشعار التوقيعX-Xtream-Signature: sha256=HMAC(secret, timestamp.body)؛ ويُعرض السر مرة واحدة عند إنشاء نقطة الاستقبال. ولا يحتوي webhook على كلمة مرور أبداً.

#API-08
API-09 توقف webhook عن الإرسال؟

تُجرَّب كل رسالة إشعار 3 مرات؛ ونقطة الاستقبال التي تفشل في 20 تسليماً متتالياً تُعطَّل. أصلح جانبك، واستخدمSend test، ثم أنشئ نقطة الاستقبال من جديد إن كانت قد عُطّلت.

#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 كيف أحصّل الأموال من عملائي؟

بنظامكالخاصوبوابة الدفع الخاصة بك. لا تعالج اللوحة المدفوعات. يربط الموصّل (connector) نظام متجرك باللوحة: يدفع العميل لديك ← يستدعي الموصّل 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)، وبعضها اختُبر جوهره فقط. اقرأ سطر «كيف اختُبر» وجرّبه في بيئة اختبار قبل البيع الفعلي.

#CON-04
CON-05 هل الموصّل آمن وماذا يفعل باللوحة؟

لا يفعل الموصّل سوى استدعاء Reseller API بمفتاح APIالخاص بك— يستطيع فعل ما تفعله أنت بالضبط ولا أكثر. الشيفرة المصدرية مفتوحة لتقرأها وتتحقق منها. أعطِ كل موصّل مفتاحاً خاصاً به مع تقييد IP (API-03).

#CON-05
CON-06 ماذا يستطيع الموصّل أن يبيع؟

الخطوط (إنشاء، تجديد، تغيير الباقة، إيقاف، حذف) وحسابات الموزعين الفرعيين مع الأرصدة.

#CON-06
CON-07 لا يوجد موصّل لمنصتي بعد؟

قم بالتكامل بنفسك عبر Reseller API (API-01) وwebhooks، أو أرسل طلباً عبر قناة الدعم.

#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 هل أُخبَر قبل انتهاء خط؟

بطريقتين: بريد ملخص يومي بالخطوط التي توشك على الانتهاء (عندما يفعّله المدير؛ قبل 3 أيام افتراضياً)، وwebhooksline.expiring/line.expiredلنظامك.

#DATA-07

حل المشكلات

FIX

افحص من الأعلى إلى الأسفل. معظم مشكلات «لا يمكنني المشاهدة» تكون في الصفوف الخمسة الأولى.

FIX-01 العميل لا يستطيع تسجيل الدخول / لا يستطيع المشاهدة المشاهد
#الفحصالعلامةما العمل
1اسم المستخدم / كلمة المروريبلّغ التطبيق عن بيانات خاطئةقارن مع نموذج الخط (حساس لحالة الأحرف، دون مسافات)؛ أعد إرسال الرابط منGenerate play link
2الانتهاءيبلّغ التطبيقExpiredجدّد (LINE-06)
3الحالةDisabled/Bannedفعّله مجدداً؛ وفي حالةBannedتواصل مع المدير
4عنوان الخادملا يتصلاستخدم العنوان والمنفذ بالضبط كما في رابط التشغيل، وhttp/httpsالصحيح
5عدد الاتصالاتيُطرد عندما يبدأ شخص آخر المشاهدةSEC-01,SEC-02
6عنوان IP محظورلا يستطيع أي خط الدخول من تلك الشبكة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 تسجيل الدخول يعمل والقائمة تظهر، لكن قناة لا تعمل المشاهد

عادةً أحد أقفال التشغيل (الصفوف 5–9 من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 لا أستطيع فتح صفحة من dashboard

ليس لمجموعتك صلاحية لتلك الصفحة (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
إشعار ترسله اللوحة إلى نظام الموزّع عند حدوث شيء

ما زالت المشكلة قائمة؟

أرسل اسم مستخدم الخط (وليس كلمة مروره أبداً)، ووقت حدوث المشكلة، والتطبيق أو الجهاز، ورمز السؤال الذي جرّبته.