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