API

Adres

Wszystko przez GET, odpowiedź zawsze w JSON, nagłówek CORS ustawiony.

Parametry

Przykłady

Odpowiedź

Skrócony przykład jednego wpisu. Pole pvp to tryb gry (Survival, SkyBlock, MiniGames...), software bywa puste, gdy serwer go nie podaje.

{
  "ok": true,
  "count": 1,
  "generated": 1790457983,
  "servers": [
    {
      "slug": "mc.hypixel.net-25565",
      "name": "Hypixel",
      "host": "mc.hypixel.net",
      "port": 25565,
      "url": "https://hypixel.net",
      "country": "us",
      "pvp": "MiniGames",
      "tags": ["bedwars", "skywars", "skyblock"],
      "online": true,
      "players": 32389,
      "max": 200000,
      "peak": 46587,
      "uptime": 99.54,
      "edition": "java",
      "version": "1.8",
      "software": "",
      "motd": "Hypixel Network [1.8/26.3]\n SKYBLOCK 0.27.1",
      "icon": "api/icon.php?s=mc.hypixel.net-25565",
      "points": 31,
      "checked": 1790457939
    }
  ]
}

Sprawdzenie dowolnego serwera

Pyta serwer na żywo, także taki, którego nie ma na liście. Bez portu: 25565 dla Java, 19132 dla Bedrock.

{
  "ok": true,
  "server": {
    "host": "mc.hypixel.net",
    "port": 25565,
    "edition": "java",
    "srv": "",
    "online": true,
    "ping": 265,
    "version": "1.8",
    "version_name": "Requires MC 1.8 / 1.21",
    "software": "",
    "protocol": 767,
    "players": { "online": 32329, "max": 200000, "peak": 0 },
    "motd": "§aHypixel Network §c[1.8/26.3]",
    "icon": true,
    "mods": 0
  }
}

Szczegóły serwera z listy

Status, historia graczy, statystyki godzinowe i dzienne, zmiany MOTD.

Ikona serwera

Obrazek PNG 64x64 z ikoną serwera (bez ikony: domyślny blok).

Karta podglądu linku

Obrazek PNG 1200x630 z nazwą, adresem, graczami, wersją gry, uptime i trybem gry. Strona serwera podaje go jako og:image, więc tak wygląda link na Discordzie i Facebooku. Język napisów wybierasz parametrem lang (pl, en albo pt).

Nagroda za głos bez otwierania portu

Votifier wymaga otwartego portu 8192: to lista puka do serwera gry. Gdy port jest zamknięty albo serwer akurat się restartuje, głos przepada. Tu jest odwrotnie: plugin na serwerze sam pyta listę o głosy zwykłym zapytaniem HTTP, kiedy chce. Żaden port nie musi być otwarty. Oba sposoby mogą działać jednocześnie.

Uwierzytelnienie: token z panelu serwera (ten sam, którym otwierasz panel), w nagłówku X-Server-Token albo w parametrze token. Nagłówek jest lepszy: adres z tokenem trafia do logów. Gracz wpisuje nick przy głosowaniu na stronie serwera.

Okno czasu zmienisz parametrem hours (1-720, domyślnie 48): gracz głosuje wieczorem, wchodzi do gry rano i nagroda nadal czeka. Claim jest jednorazowy także przy dwóch równoczesnych wywołaniach, więc restart serwera niczego nie zdubluje. Zły token: HTTP 401.

curl -H "X-Server-Token: YOUR_SERVER_TOKEN" "https://example.com/api/votes.php?action=check&username=Steve"
{ "ok": true, "username": "Steve", "voted": true, "claimed": false, "vote_id": 812, "voted_at": "2026-09-27 08:12:40", "hours": 48 }

curl -X POST -H "X-Server-Token: YOUR_SERVER_TOKEN" -H "Content-Type: application/json" \
     -d '{"action":"claim","username":"Steve"}' https://example.com/api/votes.php
{ "ok": true, "claimed": true, "username": "Steve", "vote_id": 812, "voted_at": "2026-09-27 08:12:40" }

Zasady

• Limit 20 zapytań na minutę z jednego adresu.
• Dane w cache przez 30 sekund, częstsze odpytywanie nic nie da.
• Pomiary robimy co 5 minut, więc szybsze odświeżanie u siebie nie ma sensu.
• Korzystasz publicznie? Miło, jeśli podlinkujesz źródło.

Gracze

Osobny endpoint, tylko dla serwerów, które pokazują nicki graczy online.

Pierwszy szuka graczy po fragmencie nicku (minimum 3 znaki), drugi oddaje ostatnio widzianych graczy, trzeci same liczby zbiorcze i listę serwerów, z których mamy nicki.

Widget i sygnatura

Bez pisania kodu: gotowy obrazek i ramka do wklejenia.