Public API Documentation

Buduj z RefLista.

Nasze API jest otwarte dla deweloperów. Twórz własne widżety, statystyki i integracje korzystając z naszych ustandaryzowanych endpointów.

Base URL

https://lista-serwerow-minecraft.pl/api

Interaktywny Swagger

Otwórz UI Swaggera

GET/servers

Lista Serwerów

Zwraca paginowaną listę zweryfikowanych serwerów.

Query Parameters

pageInteger

Numer strony (domyślnie 1)

limitInteger

Liczba wyników (domyślnie 20)

categoryString

Filtrowanie po kategorii (np. Survival, Skyblock)

searchString

Wyszukiwanie po nazwie, IP lub opisie

sortString

Sortuj wg: votes (głosy) lub players (gracze)

Przykład użycia

fetch('https://lista-serwerow-minecraft.pl/api/servers?limit=5&sort=votes')
  .then(res => res.json())
  .then(console.log);

GET/servers/:ip

Szczegóły Serwera

Zwraca pełne informacje o konkretnym serwerze, w tym status, MOTD, liczbę graczy online i historię.

Query Parameters

ipString

Adres IP serwera (wymagane)

Przykład użycia

fetch('https://lista-serwerow-minecraft.pl/api/servers/refmc.pl')
  .then(res => res.json())
  .then(console.log);

GET/votes/check/:serverId

Sprawdź Dostępność Głosowania

Sprawdza, czy dany adres IP lub nick może zagłosować na serwer (limit 1 głos na 24h).

Query Parameters

serverIdString

Adres IP serwera (wymagane, w ścieżce)

mcNickString

Nick gracza Minecraft (opcjonalny, query param)

Przykład użycia

fetch('https://lista-serwerow-minecraft.pl/api/votes/check/refmc.pl?mcNick=Steve')
  .then(res => res.json())
  .then(console.log);

GET/votes/voters/:serverId

Ostatni Głosujący

Pobiera listę ostatnich 10 osób, które zagłosowały na dany serwer.

Query Parameters

serverIdString

Adres IP serwera (wymagane, w ścieżce)

Przykład użycia

fetch('https://lista-serwerow-minecraft.pl/api/votes/voters/refmc.pl')
  .then(res => res.json())
  .then(console.log);

GET/promotions/packages

Pakiety Promocyjne

Zwraca listę dostępnych pakietów promocyjnych z cenami i korzyściami.

Query Parameters

Przykład użycia

fetch('https://lista-serwerow-minecraft.pl/api/promotions/packages')
  .then(res => res.json())
  .then(console.log);

Dokumentacja generowana automatycznie. Ostatnia aktualizacja: 9.03.2026