Warszawa
Łódź
Dokumentacja API LigaFanów
Wersja 1 · Bez wymaganej autoryzacji
Wprowadzenie
Witamy w dokumentacji API LigaFanów (Wersja 1). Nasze API zostało zaprojektowane, aby dostarczać deweloperom łatwy dostęp do kluczowych danych platformy LigaFanów, umożliwiając pobieranie informacji o ligach, sezonach i drużynach.
Adresy bazowe:
https://ligafanow.pl/api/v1/– dla danych dotyczących rozgrywek w Warszawie.https://lodz.ligafanow.pl/api/v1/– dla danych dotyczących rozgrywek w Łodzi.
Limity żądań: Obecnie API nie ma zdefiniowanych limitów żądań, ale prosimy użytkowników o przestrzeganie zasad uczciwego użytkowania, aby zapewnić wysoką dostępność dla wszystkich. W przyszłości mogą zostać wprowadzone limity żądań, o czym poinformujemy z wyprzedzeniem.
Kontakt i wsparcie: W przypadku pytań, problemów lub sugestii prosimy o kontakt poprzez e-mail: kontakt@ligafanow.pl.
Autoryzacja
API LigaFanów w wersji 1 jest w pełni publiczne i nie wymaga autoryzacji. Wszystkie punkty końcowe są dostępne bez konieczności stosowania kluczy API, tokenów czy innych form uwierzytelniania. Taki model dostępu ułatwia integrację i testowanie, umożliwiając deweloperom szybkie rozpoczęcie pracy. Prosimy jednak o przestrzeganie zasad uczciwego użytkowania, aby zapewnić wysoką dostępność i wydajność API dla wszystkich użytkowników.
Błędy
API LigaFanów zwraca standardowe kody błędów HTTP w przypadku niepowodzenia żądania. Poniżej znajduje się lista najczęściej występujących kodów błędów wraz z ich opisami.
Kody błędów
| Kod HTTP | Opis |
|---|---|
400 |
Błędne żądanie – żądanie zawiera nieprawidłowe parametry lub niepoprawną składnię. |
404 |
Nie znaleziono – zasób, np. liga, sezon lub drużyna, nie istnieje lub jest niedostępny. |
429 |
Zbyt wiele żądań – przekroczono limit żądań w danej jednostce czasu. |
500 |
Błąd serwera – wystąpił nieoczekiwany problem po stronie serwera. |
Metody API
Wersja 1 · Bez wymaganej autoryzacji
Przegląd
Ten punkt końcowy umożliwia pobranie listy wszystkich dostępnych lig w systemie LigaFanów. Odpowiedź zawiera identyfikatory lig oraz ich nazwy, co pozwala na łatwe przeglądanie dostępnych rozgrywek. Dane są zwracane w formacie JSON, co ułatwia integrację z aplikacjami.
Szczegóły żądania
URL: https://ligafanow.pl/api/v1/leagues
Metoda: GET
Parametry URL: Brak
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
status |
ciąg znaków | Wskazuje status odpowiedzi (np. "success"). |
code |
liczba całkowita | Kod statusu HTTP odpowiedzi (np. 200 dla sukcesu). |
data |
tablica obiektów | Lista lig dostępnych w systemie. |
data[].league_id |
liczba całkowita | Unikalny identyfikator ligi. |
data[].league_name |
ciąg znaków | Nazwa ligi (np. "Ekstraklasa"). |
Przegląd
Ten punkt końcowy umożliwia pobranie aktualnej tabeli dla ligi określonej przez identyfikator {league_id}. Odpowiedź zawiera szczegółowe informacje o każdej drużynie, w tym jej pozycję, statystyki meczowe oraz dane takie jak logo i nazwa drużyny. Dane są zwracane w formacie JSON, co ułatwia ich integrację z aplikacjami.
Szczegóły żądania
URL: https://ligafanow.pl/api/v1/table/{league_id}
Metoda: GET
Parametry URL:
| Nazwa | Typ | Opis |
|---|---|---|
league_id |
liczba całkowita | Wymagany. Identyfikator ligi, dla której pobierana jest tabela (np. 123). |
Pola odpowiedzi
| Pole | Typ | Opis |
|---|---|---|
status |
ciąg znaków | Wskazuje status odpowiedzi (np. "success"). |
code |
liczba całkowita | Kod statusu HTTP odpowiedzi (np. 200 dla sukcesu). |
data |
tablica obiektów | Lista drużyn w tabeli ligi, posortowana według pozycji. |
data[].team_id |
liczba całkowita | Unikalny identyfikator drużyny. |
data[].team_name |
ciąg znaków | Nazwa drużyny. |
data[].logo |
ciąg znaków | Adres URL do logo drużyny. |
data[].position |
liczba całkowita | Pozycja drużyny w tabeli. |
data[].statistics |
obiekt | Statystyki drużyny w lidze. |
data[].statistics.matches |
liczba całkowita | Liczba rozegranych meczów. |
data[].statistics.wins |
liczba całkowita | Liczba zwycięstw. |
data[].statistics.draws |
liczba całkowita | Liczba remisów. |
data[].statistics.losses |
liczba całkowita | Liczba porażek. |
data[].statistics.goals_scored |
liczba całkowita | Liczba strzelonych goli. |
data[].statistics.goals_conceded |
liczba całkowita | Liczba straconych goli. |
data[].statistics.goal_difference |
liczba całkowita | Różnica bramek (strzelone minus stracone). |
data[].statistics.forfeits |
liczba całkowita | Liczba walkowerów. |
data[].statistics.points |
liczba całkowita | Liczba zdobytych punktów. |