Dokumentacja API

Wprowadzenie

To API pozwala na programowy dostęp do danych serwerów. Wszystkie endpointy zwracają odpowiedzi JSON i nie wymagają autoryzacji.

URL bazowy:

https://lista-minecraft.pl

Format odpowiedzi:

application/json

Autoryzacja:

Nie wymaga autoryzacji

Dostępne endpointy

Pobierz głosy serwera

GET /api/servers/{uuid}/votes

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.

Parametry

Nazwa	Typ	Wymagany	Opis
`uuid`	string	Wymagany	Unikalny identyfikator (UUID) serwera

Przykład zapytania

cURL

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

Przykład odpowiedzi

JSON

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

Pola odpowiedzi

Pole	Typ	Opis
`nickname`	string	Nick głosującego (z formularza głosowania)
`createdAt`	string	Znacznik czasu oddania głosu (format ISO 8601 ze strefą czasową)

Kody odpowiedzi

Kod	Opis
200	Sukces - Zwraca tablicę głosów
404	Serwer nie znaleziony