Dokumentacja API

Publiczne API umożliwia pobieranie informacji o głosach (lajkach) oddanych na serwery Minecraft. Jako administrator serwera możesz z niego korzystać, aby automatycznie nagradzać graczy za oddane głosy.

Informacje ogólne

Bazowy adres API: https://artlist.dev/api
Odpowiedzi zwracane są w formacie JSON.
API nie wymaga uwierzytelniania.
Każde zapytanie musi zawierać nagłówek Accept: application/json.
Obowiązuje limit 30 zapytań na minutę.
Każdy serwer może otrzymać maksymalnie 30 lajków dziennie.
Każdy gracz może oddać tylko jednego lajka dziennie na dany serwer.

UUID serwera

Każdy serwer posiada unikatowy identyfikator (UUID), który jest wymagany do korzystania z API. UUID znajdziesz na stronie danego serwera, w sekcji z informacjami obok statusu online i wersji.

Endpointy

Pobierz głosy serwera

GET /api/servers/{uuid}/votes

Parametry zapytania (opcjonalne)

Parametr	Typ	Opis
`nick`	string	Filtruj po dokładnym nicku gracza z uwzględnieniem wielkości liter (2–128 znaków)
`date_from`	date	Głosy utworzone od podanej daty (format: `YYYY-MM-DD`)
`date_to`	date	Głosy utworzone do podanej daty (format: `YYYY-MM-DD`)
`limit`	integer	Liczba wyników na stronę (1–200, domyślnie 100)
`page`	integer	Numer strony paginacji (1–100)

Przykładowe zapytanie

GET https://artlist.dev/api/servers/376d1d89-d093-465b-a38f-32768cb296d7/votes?nick=Steve&date_from=2026-01-01&limit=50

Przykładowa odpowiedź

{
    "data": [
        {
            "nick": "Steve",
            "created_at": "2026-03-12T14:30:00+00:00"
        }
    ],
    "links": {
        "first": "https://artlist.dev/api/servers/376d1d89-d093-465b-a38f-32768cb296d7/votes?page=1",
        "last": "https://artlist.dev/api/servers/376d1d89-d093-465b-a38f-32768cb296d7/votes?page=1",
        "prev": null,
        "next": null
    },
    "meta": {
        "current_page": 1,
        "last_page": 1,
        "per_page": 100,
        "total": 1
    }
}

Uwagi

Wyniki są sortowane od najnowszych do najstarszych.
Anonimowe głosy (bez nicku) nie są zwracane przez API.
Odpowiedź zawiera paginację — użyj parametru page, aby pobrać kolejne strony wyników.

Kody błędów

Kod	Opis
`404`	Serwer o podanym UUID nie został znaleziony
`422`	Błąd walidacji — niepoprawne parametry zapytania
`429`	Przekroczono limit zapytań (30 na minutę)