كيفية إنشاء مفتاح API لـ TMDB وإضافته إلى Kodi

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

الصور التوضيحية للواجهة أدناه هي لأغراض التوضيح فقط. قد تُجري TMDB تغييرات على عناصر التحكم في الحساب، وتختلف قوائم Kodi باختلاف المظهر والجهاز والإضافات.

قبل أن تبدأ

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

يُدرج موقع TMDB نوعين من بيانات اعتماد التطبيق: مفتاح API (مصادقة الإصدار 3) ورمز الوصول للقراءة لواجهة برمجة التطبيقات (مصادقة الإصدار 4) . يوثّق TMDB كلا النوعين كطريقتين لمصادقة طلبات واجهة برمجة التطبيقات، ولكن قد يقبل ملحق معين تنسيقًا واحدًا فقط. طابق بيانات الاعتماد مع الحقل الذي يطلبه الملحق فعليًا؛ لا تقم بلصق مفتاح الإصدار 3 في حقل يطلب تحديدًا رمز الوصول للإصدار 4.

كيفية إنشاء مفتاح واجهة برمجة تطبيقات TMDB

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

   

2. افتح صفحة إعدادات واجهة برمجة التطبيقات (API). من حسابك، افتح الإعدادات واختر واجهة برمجة التطبيقات (API) من قائمة التنقل الخاصة بالحساب. تشير وثائق TMDB الحالية إلى أن رابط واجهة برمجة التطبيقات (API) جزء من إعدادات الحساب؛ وقد يتغير موضعه أو صياغته.

   

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

   

4. انتظر حتى تُصدر TMDB بيانات الاعتماد. بمجرد قبول التطبيق، ارجع إلى إعدادات واجهة برمجة التطبيقات (API) وراجع المدخلين: مفتاح واجهة برمجة التطبيقات (للمصادقة من الإصدار 3) ورمز الوصول للقراءة لواجهة برمجة التطبيقات (للمصادقة من الإصدار 4). هما بيانات اعتماد منفصلة للتطبيق. يشرح دليل مصادقة TMDB الطرق المتاحة.

   

5. انسخ بيانات الاعتماد التي يطلبها الملحق. إذا كان الحقل يُشير إلى مفتاح API، فانسخ مفتاح API (مصادقة الإصدار 3) . أما إذا طلب صراحةً رمز وصول للقراءة أو رمز حامل، فاستخدم قيمة الإصدار 4. لا تُخمن بين الاثنين، واحرص على عدم نشر بيانات اعتمادك في منشورات عامة أو لقطات شاشة.

   

كيفية إضافة المفتاح في كودي

6. افتح قسم الإضافات في برنامج Kodi. من الشاشة الرئيسية، اختر "الإضافات" وافتح متصفح الإضافات أو الإضافات المثبتة. قد تختلف الأسماء والتصميم بين إصدارات Kodi المختلفة وواجهات المستخدم.

   

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

   

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

   

إذا استمرت الأخطاء في الملحق

• لا يوجد حقل لمفتاح API: قد لا يدعم الملحق بيانات اعتماد TMDB المخصصة. لا يحتوي Kodi على إعدادات عامة يمكن أن تحل محل إعدادات الملحق.
• خطأ في المصادقة: تأكد من نسخ القيمة بالكامل ومن استخدام نوع بيانات الاعتماد المحدد من قِبل الإضافة. مفتاح API ورمز الوصول للقراءة من API حقلان مختلفان في إعدادات حساب TMDB.
• خطأ في معدل الطلبات أو الاتصال: لا يُعفي المفتاح الشخصي الطلبات من حدود TMDB. قد لا يزال الملحق يُرسل عددًا كبيرًا جدًا من الطلبات، أو قد يكون TMDB غير متاح مؤقتًا؛ راجع سجل الملحق وحالة خدمة TMDB قبل تغيير المزيد من الإعدادات.
• لا تزال الفئات تتعطل: لا يمكن للمفتاح إصلاح رمز الإضافة غير ذي الصلة، أو تكامل البيانات الوصفية القديم، أو التبعية المعطلة. قم بالتحديث فقط من مصدر موثوق واتبع أحدث وثائق الإضافة. قد تذكر الأدلة القديمة Covenant أو Elysium، لكن لهذه الإضافات إعداداتها وسجل إصداراتها الخاص؛ ولا تنطبق مسارات قوائمها على جميع إضافات Kodi.

للاستخدام غير التجاري لواجهة برمجة التطبيقات (API)، تنص الأسئلة الشائعة لواجهة برمجة التطبيقات الخاصة بـ TMDB على ضرورة الإشارة إلى مصدر البيانات والصور. وتوجه المشاريع التجارية إلى التواصل مع TMDB للاستفسار عن التراخيص. إذا كنت تقوم فقط بتكوين إضافة موجودة، فاتبع تعليمات مطور الإضافة ولا تنشر بيانات اعتمادك الشخصية.