چه کسانی می‌توانند از آن استفاده کنند؟
لیگ‌هایی که طرح «طلا» دارند و API را فعال کرده‌اند. برای فعال کردن آن، به صفحه اصلی مدیر > API > تنظیمات API بروید و گزینه فعال‌سازی JSON API را تیک بزنید. اگر هر کدام از این دو نباشد، همه نشانی‌های وب در این مقاله‌ها به جای داده‌های شما خطا برمی‌گردانند.
API چیست؟
API به یک وب‌سایت، اپلیکیشن یا برنامه دیگر اجازه می‌دهد مسابقات، نتایج و جدول‌های لیگ شما را مستقیماً از LeagueRepublic بخواند. آن را مثل یک پیشخدمت در نظر بگیرید: وب‌سایت شما چیزی درخواست می‌کند («مسابقات امروز، لطفاً») و LeagueRepublic پاسخ را برمی‌گرداند.
چطور درخواست می‌دهید؟
یک نشانی وب را باز می‌کنید، درست مثل باز کردن یک صفحه وب. به جای یک صفحه زیبا، متن ساده‌ای در قالبی به نام JSON دریافت می‌کنید. کد توسعه‌دهنده وب شما، یا صفحه‌ای که یک دستیار هوش مصنوعی ساخته است، این متن را می‌خواند و آن را به هر شکلی که طراحی کنید درمی‌آورد.
JSON چه شکلی است؟
فهرستی از برچسب‌ها و مقدارهاست، کمی شبیه یک فرم پرشده:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
کلمه قبل از دونقطه نام فیلد است (برچسب روی فرم). بخش بعد از آن مقدار است (چیزی که در خانه نوشته شده). مشخصات API توضیح می‌دهد که هر نام فیلد چه معنایی دارد.
شناسه (ID) چیست؟
هر لیگ، فصل، دسته، تیم و مسابقه در LeagueRepublic شماره مخصوص خودش را دارد که به آن شناسه (ID) می‌گویند. مثل شماره عضویت عمل می‌کند: هرگز تغییر نمی‌کند و هیچ دو چیزی شناسه یکسان ندارند. شناسه‌ها را در نشانی وب قرار می‌دهید تا مشخص کنید کدام فصل یا تیم را می‌خواهید.
چطور شناسه‌هایم را پیدا کنم؟
شناسه لیگ شما در صفحه اصلی مدیر > API > تنظیمات API نمایش داده می‌شود.
شناسه فصل شما: این نشانی را در مرورگر خود باز کنید و شناسه لیگ خود را به جای [شناسه-لیگ-من] بگذارید. فهرست فصل‌های شما، هر کدام با شناسه‌اش، نمایش داده می‌شود.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[شناسه-لیگ-من].json
شناسه‌های دسته‌ها و تیم‌ها در فهرست‌هایی که API برمی‌گرداند آمده‌اند. اگر از یکی از مقاله‌های ساخت… استفاده کنید، دستیار هوش مصنوعی آن‌ها را برایتان پیدا می‌کند.
محدودیتی وجود دارد؟
بله. هر لیگ فقط می‌تواند تعداد مشخصی درخواست در دقیقه بفرستد و این سهمیه بین همه چیزهایی که از داده‌های لیگ شما استفاده می‌کنند مشترک است: وب‌سایت، اپلیکیشن‌ها و هر چیز دیگر. یک صفحه خوب‌ساخته آنچه را بارگیری می‌کند ذخیره می‌کند و آن را بارها و بارها درخواست نمی‌کند. مشخصات API محدودیت دقیق را بیان می‌کند.
چند واژه که خواهید دید
Road – تیم میهمان. LeagueRepublic از "road" استفاده می‌کند، جایی که بیشتر مردم می‌گویند «میهمان» ("away").
Fixture – یک مسابقه، چه برگزار شده باشد چه نه.
Fixture group – یک دسته (مثل «لیگ برتر»)، یک جام یا گروه دیگری از مسابقات.
Result – مسابقه‌ای که نتیجه دارد.
null – خانه خالی است. لیگ آن را وارد نکرده یا کاربردی ندارد.
true / false – بله / خیر.
جزئیات کامل کجاست؟
همه جزئیات دقیق، مانند هر نام فیلد، محدودیت و پیام‌های خطا، در مشخصات API آمده است: