Кой може да го използва?
Лигите с плана Gold, които са включили API. За да го включите, отидете в Начална страница на администрацията > API > Настройки на API и отметнете Включване на JSON API. Ако липсва едното от двете, всеки уеб адрес в тези статии връща грешка вместо вашите данни.
Какво е това?
API позволява на друг уебсайт, приложение или програма да чете мачовете, резултатите и таблиците на вашата лига директно от LeagueRepublic. Представете си го като сервитьор: вашият уебсайт поиска нещо („днешните мачове, моля“), а LeagueRepublic връща отговора.
Как се прави заявка?
Посещавате уеб адрес, точно както отваряте уеб страница. Вместо красиво изглеждаща страница получавате обикновен текст във формат, наречен JSON. Кодът на вашия уеб разработчик или страница, направена от AI асистент, чете този текст и го превръща в каквото сте проектирали.
Как изглежда JSON?
Това е списък от етикети и стойности, малко като попълнен формуляр:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Думата преди двоеточието е името на полето (етикетът във формуляра). Това след нея е стойността (какво е написано в полето). Спецификацията на API обяснява какво означава всяко име на поле.
Какво е ID?
Всяка лига, сезон, дивизия, отбор и мач в LeagueRepublic има собствен номер, наречен ID. Той работи като членски номер: никога не се променя и две неща не го споделят. Поставяте ID във уеб адреса, за да кажете кой сезон или отбор искате.
Как да намеря своите ID?
ID на вашата лига се показва в Начална страница на администрацията > API > Настройки на API.
ID на вашия сезон: отворете този адрес в браузъра си, като вместо [MY-LEAGUE-ID] поставите ID на вашата лига. Той изброява вашите сезони, всеки с неговото ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID на дивизии и отбори се появяват в списъците, които API връща. Ако използвате някоя от статиите Създаване на…, AI асистентът ги търси вместо вас.
Има ли ограничение?
Да. Всяка лига може да прави само определен брой заявки в минута, споделени от всичко, което използва данните на вашата лига: вашия уебсайт, приложения и всичко останало. Добре направената страница запазва заредените данни, вместо да иска отново и отново. Спецификацията на API дава точното ограничение.
Няколко думи, които ще срещнете
Road – гостуващият отбор. LeagueRepublic казва „road“ там, където повечето хора казват „away“ (гост).
Fixture – мач, независимо дали вече е изигран или не.
Fixture group – дивизия (например „Premier Division“), турнир или друга група от мачове.
Result – мач, който има резултат.
null – полето е празно. Лигата не го е въвела или то не се отнася.
true / false – да / не.
Къде са пълните подробности?
Всичко точно, като всяко име на поле, ограничението и съобщенията за грешка, е в спецификацията на API: