Кой може да го използва?
Лиги с плана 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 на вашия сезон: отворете този адрес в браузъра си, като поставите ID на лигата си на мястото на [ID-НА-МОЯТА-ЛИГА]. Ще видите списък с вашите сезони, всеки със своето ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-НА-МОЯТА-ЛИГА].json
ID на дивизиите и отборите се съдържат в списъците, които API връща. Ако използвате някоя от статиите Създайте…, AI асистентът ще ги намери вместо вас.
Има ли ограничение?
Да. Всяка лига може да прави само определен брой заявки в минута, които се споделят от всичко, което използва данните на лигата ви: вашия уебсайт, приложения и всичко останало. Добре направената страница запазва заредените данни, вместо да пита отново и отново. Точното ограничение е посочено в спецификацията на API.
Няколко думи, които ще срещнете
Road – гостуващият отбор. LeagueRepublic казва "road" там, където повечето хора казват „като гост“.
Fixture – мач, независимо дали вече е изигран, или не.
Fixture group – дивизия (например „Premier Division“), купа или друга група мачове.
Result – мач, който има резултат.
null – полето е празно. Лигата не го е попълнила или то не се отнася за случая.
true / false – да / не.
Къде са всички подробности?
Всички точни подробности, като всяко име на поле, ограничението и съобщенията за грешки, са в спецификацията на API: