من يمكنه استخدامها؟
الدوريات المشتركة في الخطة «الذهبية» (Gold) والتي فعّلت واجهة برمجة التطبيقات. لتفعيلها، انتقل إلى الصفحة الرئيسية للمسؤول > API > إعدادات API وحدّد تفعيل JSON API. إذا لم يتوفر أي منهما، فستُرجع كل عناوين الويب في هذه المقالات خطأً بدلاً من بياناتك.
ما هي؟
تتيح واجهة برمجة التطبيقات لموقع ويب أو تطبيق أو برنامج آخر قراءة مباريات دوريك ونتائجه وجداول ترتيبه مباشرة من LeagueRepublic. تخيّلها مثل النادل: يطلب موقعك شيئاً ("مباريات اليوم من فضلك")، فتُحضر LeagueRepublic الإجابة.
كيف تطلب البيانات؟
تزور عنوان ويب، تماماً كما تفتح صفحة ويب. لكن بدلاً من صفحة جميلة الشكل، تحصل على نص عادي بتنسيق يُسمى JSON. تقرأ شيفرة مطوّر الويب لديك، أو صفحة أنشأها مساعد ذكاء اصطناعي، هذا النص وتحوّله إلى أي تصميم تريده.
كيف يبدو JSON؟
إنه قائمة من التسميات والقيم، تشبه قليلاً استمارة تمت تعبئتها:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
الكلمة التي تسبق النقطتين هي اسم الحقل (التسمية في الاستمارة). والجزء الذي يليها هو القيمة (ما كُتب في الخانة). توضح مواصفات واجهة برمجة التطبيقات معنى كل اسم حقل.
ما هو المعرّف (ID)؟
لكل دوري وموسم وقسم وفريق ومباراة في LeagueRepublic رقم خاص به يُسمى المعرّف (ID). وهو يعمل مثل رقم العضوية: لا يتغير أبداً، ولا يتشارك شيئان في الرقم نفسه. تضع المعرّفات في عنوان الويب لتحدد الموسم أو الفريق الذي تريده.
كيف أجد المعرّفات الخاصة بي؟
معرّف دوريك معروض في الصفحة الرئيسية للمسؤول > API > إعدادات API.
معرّف موسمك: افتح هذا العنوان في متصفحك، مع وضع معرّف دوريك مكان [معرّف-الدوري-الخاص-بي]. ستظهر قائمة بمواسمك، ولكل منها معرّفه.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[معرّف-الدوري-الخاص-بي].json
معرّفات الأقسام والفرق تظهر في القوائم التي ترسلها واجهة برمجة التطبيقات. إذا استخدمت أحد مقالات أنشئ…، فسيبحث عنها مساعد الذكاء الاصطناعي نيابةً عنك.
هل هناك حد؟
نعم. يمكن لكل دوري إرسال عدد محدد فقط من الطلبات في الدقيقة، ويتشارك هذا العدد كل ما يستخدم بيانات دوريك: موقعك والتطبيقات وأي شيء آخر. الصفحة المصممة جيداً تحفظ ما تحمّله بدلاً من الطلب مراراً وتكراراً. تذكر مواصفات واجهة برمجة التطبيقات الحد الدقيق.
بعض الكلمات التي ستراها
Road – الفريق الضيف. تستخدم LeagueRepublic كلمة "road" حيث يقول معظم الناس "خارج الأرض".
Fixture – مباراة، سواء لُعبت بعد أم لا.
Fixture group – قسم (مثل "Premier Division")، أو كأس، أو مجموعة أخرى من المباريات.
Result – مباراة لها نتيجة.
null – الخانة فارغة. لم يُدخلها الدوري، أو أنها لا تنطبق.
true / false – نعم / لا.
أين أجد كل التفاصيل؟
كل التفاصيل الدقيقة، مثل كل اسم حقل والحد ورسائل الخطأ، موجودة في مواصفات واجهة برمجة التطبيقات: