Dokumentacja API

Pobiera listę głosów dla określonego serwera z ostatnich 7 dni. Zwraca zanonimizowane dane głosów zawierające nicki głosujących i czasy głosowania.

curl -X GET 'http://lista-minecraft.pl/api/servers/your-server-uuid/votes' \
 -H 'Accept: application/json'

[
 {
 "nickname": "HeVer_",
 "createdAt": "2025-11-07T19:04:55+01:00"
 },
 {
 "nickname": "PlayerName",
 "createdAt": "2025-11-07T18:30:12+01:00"
 }
]

Pobiera najnowszą publiczną aktywność — ostatnie głosy, recenzje i nowo dodane serwery — połączoną w kolejności od najnowszych. Są to te same dane, które pokazuje ticker aktywności na żywo na stronie.

curl -X GET 'http://lista-minecraft.pl/api/v1/live-ticker?limit=15' \
 -H 'Accept: application/json'

[
 {
 "type": "vote",
 "username": "HeVer_",
 "serverHost": "play.example.com",
 "serverPath": "/servers/minecraft/1f2e...",
 "createdAt": "2026-08-03T19:04:55+00:00"
 }
]

Pobiera filtrowalną i sortowalną kolekcję głosów ze wszystkich publicznie widocznych serwerów. Zwraca zanonimizowane dane głosów wraz z odniesieniem do serwera, na który oddano głos.

curl -X GET 'http://lista-minecraft.pl/api/v1/votes?server.game.slug=minecraft&order[createdAt]=desc' \
 -H 'Accept: application/json'

[
 {
 "uuid": "9c1e...",
 "nickname": "HeVer_",
 "createdAt": "2026-08-03T19:04:55+00:00",
 "serverUuid": "1f2e...",
 "serverHost": "play.example.com"
 }
]

Zwraca kolekcję typów serwerów (trybów gry) używanych do kategoryzowania serwerów. Każdy element udostępnia uuid, nazwę, slug, opisy oraz odnośnik do gry. Użyj zwróconego sluga w filtrze ?serverTypes.slug= na endpoincie serwerów.

curl -X GET 'http://lista-minecraft.pl/api/v1/server-types?game.slug=minecraft' \
 -H 'Accept: application/json'

Zwraca kolekcję wersji serwerów obsługiwanych dla poszczególnych gier. Każdy element udostępnia uuid, wartość, slug, opisy oraz odnośnik do gry. Użyj zwróconego sluga w filtrze ?serverVersions.slug= na endpoincie serwerów.

curl -X GET 'http://lista-minecraft.pl/api/v1/server-versions?game.slug=minecraft' \
 -H 'Accept: application/json'

Zwraca kolekcję publicznie widocznych map. Każdy element udostępnia uuid, nazwę, slug oraz odnośnik do gry. Mapy nieopublikowane dla wszystkich nigdy nie są zwracane.

curl -X GET 'http://lista-minecraft.pl/api/v1/maps?game.slug=minecraft' \
 -H 'Accept: application/json'

Zwraca filtrowalną i sortowalną kolekcję zatwierdzonych wydarzeń w grach. Każdy element udostępnia uuid, tytuł, opis, adres URL, daty rozpoczęcia/zakończenia oraz odnośnik do gry. Wydarzenia oczekujące na moderację nigdy nie są zwracane.

curl -X GET 'http://lista-minecraft.pl/api/v1/events?order[startsAt]=asc' \
 -H 'Accept: application/json'

Zwraca kolekcję aktualnie opublikowanych ogłoszeń serwisu. Każdy element udostępnia uuid, treść w języku polskim i angielskim, typ, opcjonalną datę wygaśnięcia oraz znaczniki czasu. Zwracane są wyłącznie aktywne, niewygasłe ogłoszenia — wersje robocze i wygasłe są ukrywane.

curl -X GET 'http://lista-minecraft.pl/api/v1/announcements?type=critical' \
 -H 'Accept: application/json'