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