Kto może z niego korzystać?
Ligi w planie Gold, które włączyły API. Aby je włączyć, przejdź do Strona główna administratora > API > Ustawienia API i zaznacz Włącz JSON API. Jeśli brakuje któregokolwiek z tych warunków, każdy adres internetowy z tych artykułów zwróci błąd zamiast Twoich danych.
Co to jest?
API pozwala innej witrynie, aplikacji lub programowi odczytywać terminarz, wyniki i tabele Twojej ligi bezpośrednio z LeagueRepublic. Pomyśl o nim jak o kelnerze: Twoja strona o coś prosi („poproszę dzisiejsze mecze”), a LeagueRepublic przynosi odpowiedź.
Jak o coś poprosić?
Otwierasz adres internetowy, tak samo jak zwykłą stronę. Zamiast ładnie wyglądającej strony dostajesz zwykły tekst w formacie o nazwie JSON. Kod Twojego programisty albo strona zbudowana przez asystenta AI odczytuje ten tekst i zamienia go w to, co zaprojektujesz.
Jak wygląda JSON?
To lista etykiet i wartości, trochę jak wypełniony formularz:
{ "homeTeamName": "Arthurlie", "homeScore": "2" } |
Słowo przed dwukropkiem to nazwa pola (etykieta w formularzu). To, co jest po nim, to wartość (to, co wpisano w pole). Specyfikacja API wyjaśnia, co oznacza każda nazwa pola.
Co to jest ID?
Każda liga, sezon, dywizja, drużyna i mecz w LeagueRepublic ma własny numer, nazywany ID. Działa jak numer członkowski: nigdy się nie zmienia i żadne dwie rzeczy nie mają tego samego. Wpisujesz ID w adres internetowy, aby wskazać, o który sezon lub drużynę Ci chodzi.
Jak znaleźć moje ID?
ID Twojej ligi znajdziesz w Strona główna administratora > API > Ustawienia API.
ID Twojego sezonu: otwórz ten adres w przeglądarce, wstawiając ID swojej ligi w miejsce [ID-MOJEJ-LIGI]. Zobaczysz listę swoich sezonów, każdy z jego ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[ID-MOJEJ-LIGI].json
ID dywizji i drużyn pojawiają się na listach, które zwraca API. Jeśli korzystasz z jednego z artykułów Zbuduj…, asystent AI wyszuka je za Ciebie.
Czy jest jakiś limit?
Tak. Każda liga może wysłać tylko określoną liczbę zapytań na minutę, wspólną dla wszystkiego, co korzysta z danych Twojej ligi: strony, aplikacji i wszystkiego innego. Dobrze zrobiona strona zapamiętuje to, co pobrała, zamiast pytać w kółko. Dokładny limit podaje specyfikacja API.
Kilka słów, które zobaczysz
Road – drużyna gości. LeagueRepublic używa słowa „road” tam, gdzie większość mówi „away” (na wyjeździe).
Mecz (fixture) – spotkanie, niezależnie od tego, czy zostało już rozegrane.
Grupa meczów (fixture group) – dywizja (np. „Premier Division”), puchar lub inna grupa meczów.
Wynik (result) – mecz, który ma już rezultat.
null – pole jest puste. Liga go nie wypełniła albo nie ma zastosowania.
true / false – tak / nie.
Gdzie są wszystkie szczegóły?
Wszystkie dokładne informacje, takie jak każda nazwa pola, limit i komunikaty o błędach, znajdziesz w specyfikacji API: