# REST API لمنصات OTT | Vodlix

**Source:** https://vodlix.com/ar/features/restful-api  
**Summary:** أدِر منصة البث الخاصة بك عبر الكود. تحكّم في الفيديوهات والمسلسلات والقنوات المباشرة والصور الفنية وقوائم المحتوى عبر API يغطي كل ما تقوم به لوحة الإدارة.  
**Publisher:** Vodlix

---

## Restful API

احصل على REST API قوي وآمن للتكامل السريع وأتمتة العمليات وتبسيط سير العمل.

- **Feature Plan:** 2

- core-platform
- back-end

تحكّم في الكتالوج والصور الفنية والقنوات المباشرة والعرض الترويجي والتقارير عبر REST API يحاكي لوحة الإدارة.

استدعاء «Add New Video» في وثائق API الخاصة بالمنصة على حاسوب محمول، مع العنوان نفسه مفتوحًا في تطبيق على الهاتف

وثائق API الخاصة بـ «Update Content Thumbs»، الذي يحدد الصور الفنية العمودية والأفقية وصورة الشعار لعنوان ما من روابط الصور

### الصور الفنية والقنوات المباشرة عبر API

عبر Vodlix API، تُرفق الصور الفنية عبر رابط بدلًا من رفعها يدويًا. يحدد استدعاء واحد الصور العمودية والأفقية وصورة الشعار لعنوان ما، ويختار استدعاء آخر أي إطار مُولَّد يُستخدم كصورة مصغّرة. وتُدار القنوات المباشرة مثل الفيديوهات: تُنشأ من رابط بث، وتُحدَّث، وتُنشر أو يُلغى نشرها، وتُنقل إلى سلة المهملات أو تُستعاد، فيُؤتمت المحتوى الخطي بالطريقة نفسها التي يُؤتمت بها المحتوى عند الطلب. وفي الكتالوج الكبير أو كثير التغيّر، يحافظ ذلك على اتساق الصور الفنية دون أن يضطر أحد إلى رفع الملفات واحدًا تلو الآخر.

#### REST API

مألوف ويمكن التنبؤ به.

#### يحاكي لوحة الإدارة

إذا كنت تعرف الواجهة، فأنت تعرف API.

#### دورة حياة كاملة

إنشاء ونشر وإلغاء نشر واستعادة.

وثائق API الخاصة بـ «Upload with URL»، الذي يستقبل فيديو من رابط ملف على تخزين عام أو S3 أو Wasabi

### أدِر الكتالوج برمجيًا

يتيح لك Vodlix REST API إدارة الكتالوج برمجيًا بما يحاكي لوحة الإدارة. يمكن إنشاء الفيديوهات وتحديثها ونشرها أو إلغاء نشرها، ونقلها إلى سلة المهملات أو استعادتها. وتُنشأ المسلسلات والمواسم وتُحدَّث وتُنشر بالطريقة نفسها، وتُربط الحلقات بموسم أو تُفصل عنه. وتُستقبَل الفيديوهات الجديدة بإعطاء المنصة رابط ملف، عامًا أو في مساحة تخزين S3 أو Wasabi الخاصة بك: فتجلب الملف وتعالجه في الخلفية وتُرجع معرّف فيديو لتتبّعه. وبالنسبة لمشغّلي OTT الذين لديهم أنظمة قائمة، يمكن أتمتة إدارة الكتالوج بدلًا من تنفيذها يدويًا.

الصفحة الرئيسية للمتجر مع صفّي «Top 10» و«Rent the Latest»، وهما قائمتا محتوى يمكن تشغيلهما وإيقافهما باستدعاء API

### العرض الترويجي وقوائم المحتوى تحت تحكّم API

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

- mx-auto

جدول أدوات MCP Access يعرض معلومات المنصة وأعداد المحتوى والمستخدمين وتصفح الكتالوج وملخص المبيعات

### نقاط نهاية المرجع والتقارير

يوفر Vodlix API استدعاءات مرجعية وتقارير: معرّفات الفئات، وأعداد الكتالوج والمستخدمين، وملخص مبيعات لأي نطاق زمني، وتفاصيل المنصة مثل إصدار البرنامج. تعرف عمليات التكامل دائمًا ما الذي تعمل عليه، ويمكنها التكيّف مع تغييرات المنصة. ويعتمد الوصول على مفاتيح API تُنشأ في لوحة الإدارة: مفتاح خادم لمهام الواجهة الخلفية، ومفتاح عميل لكود المتصفح لا يمكنه أبدًا الوصول إلى مسارات الإدارة. وتُتاح الاستدعاءات نفسها لمساعدي الذكاء الاصطناعي عبر موصّل MCP الخاص بالمنصة.

### أين يثبت قيمته عادةً

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

كما يربط API منصتك ببقية أعمالك. أرسل عنوانًا جديدًا إلى نظام إدارة المحتوى وموقعك التسويقي لحظة نشره، أو مرّر [قوائم المحتوى](/ar/features/content-lists) إلى خدمة توصيات واكتب النتائج مرة أخرى. وعندما يحتاج التكامل إلى أكثر مما يوفره API وحده، تتولى [خدمة الإضافات المخصصة](/ar/services/custom-plugin) لدينا بناء الجزء الناقص على المنصة نفسها.

تتوفر التحليلات عبر API عندما تكون خدمة إحصاءات مهيأة على السحابة الخاصة بك، ومن الأفضل التأكد من ذلك أثناء الإعداد بدلًا من اكتشافه لاحقًا. تشرح صفحة [التقارير والتحليلات](/ar/features/reports-and-analytics) ما الذي يتم قياسه.

**Q: ما الذي يمكن أن يتحكم فيه Vodlix REST API؟**

يتحكم Vodlix REST API في الكتالوج، بما في ذلك الفيديوهات والمسلسلات والمواسم والحلقات، إضافة إلى الصور الفنية والقنوات المباشرة وقوائم المحتوى والعرض الترويجي، وبيانات المرجع والتقارير.

**Q: هل أرفع ملفات الفيديو عبر Vodlix API؟**

تُستقبَل الفيديوهات الجديدة عبر Vodlix API بتقديم رابط HTTPS عام. يجلب Vodlix الملف ويحوّل ترميزه، فلا تحتاج إلى تمرير ملفات ثنائية عبر بنيتك التحتية.

**Q: هل يطابق Vodlix API لوحة الإدارة؟**

نعم. يحاكي Vodlix REST API لوحة الإدارة، باتباع اصطلاحات REST المألوفة واستجابات يمكن التنبؤ بها، لذا فإن من يعرف الواجهة يعرف تقريبًا ما يستطيع API فعله.

**Q: هل يمكنني إدارة قوائم المحتوى عبر Vodlix API؟**

نعم. يمكن إنشاء قوائم المحتوى في Vodlix ومجموعات القوائم وعناصرها وترتيبها وتحديثها وتفعيلها وإيقافها عبر API، ما يتيح أتمتة العرض الترويجي.

**Q: ما بيانات التقارير التي يوفرها Vodlix API؟**

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

**Q: هل معرّفات الفئات واحدة في كل سحابة من سحابات Vodlix؟**

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

**Q: هل يمكننا الحصول على التحليلات عبر API؟**

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

**Q: هل يفيد API في الانتقال من منصة أخرى؟**

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

**Q: كيف تُصادِق عمليات التكامل مع Vodlix API؟**

باستخدام مفتاح API يُنشأ في لوحة الإدارة ضمن «Apps & APIs» ويُرسل في الترويسة X-Api-Key. يعمل مفتاح الخادم بصلاحيات المستخدم الذي ينتمي إليه ويمكنه الوصول إلى مسارات الإدارة، لذا مكانه الواجهة الخلفية. أما مفتاح العميل فآمن لكود المتصفح وممنوع من جميع مسارات الإدارة. ويمكن أن تحمل المفاتيح تاريخ انتهاء صلاحية، وحذف المفتاح يُلغيه على الفور.