Kto może z tego 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.
Czym ono jest?
API pozwala innej stronie, aplikacji lub programowi odczytywać mecze, wyniki i tabele Twojej ligi prosto z LeagueRepublic. Pomyśl o nim jak o kelnerze: Twoja strona prosi o coś („dzisiejsze mecze, poproszę”), a LeagueRepublic przynosi odpowiedź.
Jak o to prosić?
Wchodzisz pod adres internetowy, tak jak podczas otwierania strony. Zamiast ładnie wyglądającej strony dostajesz zwykły tekst w formacie zwanym JSON. Kod Twojego programisty albo strona stworzona przez asystenta AI odczytuje ten tekst i zamienia go na 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 polu). Specyfikacja API wyjaśnia, co oznacza każda nazwa pola.
Czym jest ID?
Każda liga, sezon, dywizja, drużyna i mecz w LeagueRepublic ma własny numer, zwany ID. Działa jak numer członkowski: nigdy się nie zmienia i żadne dwie rzeczy nie mają tego samego. ID wpisujesz w adres internetowy, aby wskazać, o jaki sezon lub drużynę chodzi.
Jak znaleźć swoje ID?
ID Twojej ligi jest widoczne w Strona główna administratora > API > Ustawienia API.
ID Twojego sezonu: otwórz ten adres w przeglądarce, wpisując ID swojej ligi w miejsce [MY-LEAGUE-ID]. Wyświetli listę Twoich sezonów, każdy z jego ID.
https://api.leaguerepublic.com/json/getSeasonsForLeague/[MY-LEAGUE-ID].json
ID dywizji i drużyn pojawiają się na listach zwracanych przez API. Jeśli korzystasz z jednego z artykułów Zbuduj…, asystent AI znajdzie je za Ciebie.
Czy jest limit?
Tak. Każda liga może wysyłać tylko określoną liczbę zapytań na minutę, wspólną dla wszystkiego, co korzysta z danych Twojej ligi: strony, aplikacji i innych rozwiązań. Dobrze zrobiona strona zapisuje to, co załadowała, zamiast pytać w kółko od nowa. 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ść ludzi mówi „away” (na wyjeździe).
Fixture – mecz, niezależnie od tego, czy został już rozegrany.
Fixture group – dywizja (np. „Premier Division”), puchar lub inna grupa meczów.
Result – fixture, który ma wynik.
null – pole jest puste. Liga go nie wpisała albo nie dotyczy.
true / false – tak / nie.
Gdzie znajdę wszystkie szczegóły?
Wszystko, co dokładne, jak każda nazwa pola, limit i komunikaty o błędach, znajduje się w specyfikacji API: