API Dokumentacja

Integruj nasz system głosowania z Twoim serwerem Minecraft. Nagradzaj graczy za głosy automatycznie!

🔌 Jak działa nasze API?

Nasze API pozwala Twojemu serwerowi Minecraft sprawdzić, czy dany gracz zagłosował w danym dniu. Dzięki temu możesz automatycznie nagradzać graczy, którzy wspierają Twój serwer poprzez głosowanie.

⚡

Szybkie odpowiedzi

API odpowiada w milisekundach — brak opóźnień w grze.

🔒

Bez klucza API

Nie wymagamy rejestracji ani klucza. Wystarczy znać ID serwera.

🎁

Nagradzaj graczy

Automatyczne nagrody za głosowanie motywują do codziennej aktywności.

📡 Endpoint

Sprawdź, czy gracz o podanym nicku zagłosował dzisiaj na Twój serwer.

GET https://mcserwerylista.pl/api/{server_id}/{nick}

Parametry URL

Parametr	Typ	Opis
`server_id`	integer	ID Twojego serwera na naszej liście. Znajdziesz go w URL strony serwera, np. `/serwer/7`
`nick`	string	Nick gracza Minecraft (3-16 znaków; litery, cyfry, podkreśnik)

📋 Odpowiedzi

200 Gracz zagłosował dzisiaj

{
  "voted": true
}

200 Gracz NIE zagłosował dzisiaj

{
  "voted": false
}

400 Błąd walidacji

{
  "error": "Nieprawidłowe ID serwera."
}

429 Zbyt wiele żądań

{
  "error": "Too many requests. Slow down."
}

⚠️ Limity

120

żądań na minutę per IP

JSON

format odpowiedzi

GET

jedyna metoda HTTP

💻 Przykład użycia

Poniżej znajdziesz przykłady integracji w różnych językach. Skopiuj i dostosuj do swojego plugin'u!

// Sprawdzenie głosu gracza w pluginie Bukkit/Spigot
import java.net.HttpURLConnection;
import java.net.URL;
import java.io.BufferedReader;
import java.io.InputStreamReader;

public boolean hasVotedToday(String nick) {
    try {
        URL url = new URL("https://mcserwerylista.pl/api/TWOJE_ID/" + nick);
        HttpURLConnection con = (HttpURLConnection) url.openConnection();
        con.setRequestMethod("GET");

        BufferedReader in = new BufferedReader(
            new InputStreamReader(con.getInputStream())
        );
        String response = in.readLine();
        in.close();

        return response.contains("true");
    } catch (Exception e) {
        e.printStackTrace();
        return false;
    }
}

// Sprawdzenie głosu gracza w Node.js
async function hasVotedToday(serverId, nick) {
  const res = await fetch(
    `https://mcserwerylista.pl/api/${serverId}/${nick}`
  );
  const data = await res.json();
  return data.voted;
}

// Użycie:
const voted = await hasVotedToday(7, "Steve");
console.log(voted); // true lub false

# Sprawdzenie czy gracz "Steve" zagłosował na serwer ID 7
curl -s https://mcserwerylista.pl/api/7/Steve

# Przykładowa odpowiedź:
{"voted": true}