Хто може ним користуватися?
Ліги на плані Золото (Gold), які увімкнули API. Щоб увімкнути його, перейдіть до Головна сторінка адміністратора > API > Налаштування API і позначте Увімкнути JSON API. Якщо чогось із цього бракує, кожна веб-адреса в цих статтях повертатиме помилку замість ваших даних.
Що це таке?
API дає змогу іншому веб-сайту, додатку чи програмі читати розклад матчів, результати й таблиці вашої ліги безпосередньо з LeagueRepublic. Уявіть його як офіціанта: ваш сайт щось просить («сьогоднішні матчі, будь ласка»), а LeagueRepublic приносить відповідь.
Як зробити запит?
Ви відкриваєте веб-адресу, так само як відкриваєте веб-сторінку. Але замість гарної сторінки ви отримуєте звичайний текст у форматі, який називається JSON. Код вашого веб-розробника або сторінка, створена ШІ-асистентом, читає цей текст і перетворює його на те, що ви задумали.
Який вигляд має JSON?
Це список позначок і значень, трохи схожий на заповнену анкету:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Слово перед двокрапкою — це назва поля (позначка в анкеті). Частина після неї — це значення (те, що вписано в клітинку). У специфікації API пояснено, що означає кожна назва поля.
Що таке ID?
Кожна ліга, сезон, дивізіон, команда й матч у LeagueRepublic мають власний номер, який називається ID. Він працює як членський номер: ніколи не змінюється, і двох однакових не буває. Ви додаєте ID у веб-адресу, щоб указати, який сезон чи яку команду хочете отримати.
Як знайти свої ID?
ID вашої ліги показано на сторінці Головна сторінка адміністратора > API > Налаштування API.
ID вашого сезону: відкрийте цю адресу в браузері, підставивши ID своєї ліги замість [ID-МОЄЇ-ЛІГИ]. Ви побачите список своїх сезонів, кожен зі своїм ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-МОЄЇ-ЛІГИ].json
ID дивізіонів і команд з'являються у списках, які повертає API. Якщо ви користуєтеся однією зі статей Створіть…, ШІ-асистент знайде їх за вас.
Чи є обмеження?
Так. Кожна ліга може надсилати лише певну кількість запитів на хвилину, і цей ліміт спільний для всього, що використовує дані вашої ліги: вашого сайту, додатків та всього іншого. Добре зроблена сторінка зберігає завантажене, а не запитує знову й знову. Точний ліміт указано в специфікації API.
Кілька слів, які ви побачите
Road — команда гостей. LeagueRepublic каже «road» там, де більшість людей каже «на виїзді».
Матч (fixture) — гра, незалежно від того, зіграна вона вже чи ні.
Група матчів (fixture group) — дивізіон (наприклад, «Premier Division»), кубок або інша група матчів.
Результат (result) — матч, який має рахунок.
null — клітинка порожня. Ліга її не заповнила, або вона не застосовується.
true / false — так / ні.
Де знайти всі подробиці?
Усі точні відомості, як-от кожна назва поля, ліміт і повідомлення про помилки, є в специфікації API: