API MineListu umožňuje vašemu serveru zjistit, zda hráč hlasoval, vydat odměnu právě jednou a načíst veřejné statistiky. Všechny endpointy vracejí JSON a používají obyčejné HTTPS požadavky GET, takže fungují z jakéhokoli jazyka.
Jak získat API klíč
Přidejte svůj server, potvrďte ho jako svůj a otevřete panel majitele. API klíč najdete v nastavení serveru. Držte ho v soukromí, protože identifikuje váš server. Pokud unikne, vygenerujte v panelu nový a aktualizujte plugin nebo skript.
Základní adresa všech endpointů je https://minelist.eu.
Kontrola hlasu
GET /api/v1/vote?key=API_KEY&username=NICKVrátí, zda hráč dnes hlasoval a zda už byla odměna vyzvednuta.
{"voted":true,"claimed":false,"next_vote_utc":"2026-10-31T00:00:00Z"}votedje true, pokud má nick pro váš server hlas v aktuálním dni UTC.claimedje true, pokud jste hlas už označili jako vyzvednutý.next_vote_utcje čas, kdy může hráč hlasovat znovu.
Vyzvednutí hlasu
GET /api/v1/vote/claim?key=API_KEY&username=NICKOznačí dnešní hlas jako vyzvednutý. Zavolejte ho těsně před vydáním odměny, aby si hráč nemohl odměnu vzít dvakrát. Možné odpovědi:
| Odpověď | Význam |
|---|---|
{"voted":true,"claimed":true} | Hlas byl platný a je nyní vyzvednutý. Vydejte odměnu. |
{"voted":true,"claimed":false,"already_claimed":true} | Hlas už byl vyzvednut dříve. Nevydávejte nic. |
{"voted":false,"claimed":false} | Hráč dnes nehlasoval. |
Seznam hlasů za tento měsíc
GET /api/v1/votes?key=API_KEYVrátí všechny hlasy, které váš server v aktuálním měsíci dostal. Hodí se pro měsíční odměny nejlepším hlasujícím a žebříčky na vašem webu.
Veřejné statistiky serveru
GET /api/v1/server/<slug>Tento endpoint klíč nepotřebuje. Slug je poslední část adresy serveru na MineListu. Vrácená pole:
| Pole | Popis |
|---|---|
name | Název serveru |
url | Web serveru |
ip | Adresa pro připojení |
online | Zda poslední kontrola uspěla |
players | Počet hráčů při poslední kontrole |
max_players | Počet slotů |
version | Verze serveru |
votes_month | Hlasy za tento měsíc |
votes_total | Hlasy od přidání serveru |
uptime_30 | Dostupnost za posledních 30 dní v procentech |
rating | Průměrné hodnocení |
last_check | Čas poslední kontroly |
Příklad s curl
Takto vypadá celá logika v shellu. Totéž udělá jakýkoli jazyk, který umí poslat HTTP požadavek, třeba Java, PHP, Python nebo Node.js.
curl -s "https://minelist.eu/api/v1/vote/claim?key=API_KEY&username=Steve"Zpracujte JSON, a pokud je claimed true, spusťte příkaz s odměnou, například give Steve diamond 3.
Podpora NuVotifieru
Chcete-li odměny okamžitě a bez dotazování, MineList umí hlasy posílat na váš server přes NuVotifier. Podporujeme obě verze protokolu. Verze 1 používá veřejný klíč RSA, verze 2 token.
- Nainstalujte NuVotifier na server a restartujte ho.
- V panelu majitele zadejte hostitele, port (výchozí je 8192) a veřejný klíč (v1) nebo token (v2).
- Klikněte na Poslat testovací hlas a zkontrolujte, že ho server zapíše do logu.
Pokud test selže, ověřte, že je port Votifieru otevřený ve firewallu a že jste klíč zkopírovali bez mezer a zalomení řádků.
Živý banner
Každý server má živý banner o velikosti 468x60 pixelů se stavem a počtem hráčů:
https://minelist.eu/banner/<slug>.pngPříklad vložení do HTML:
<a href="https://minelist.eu/cs/server/vas-slug">
<img src="https://minelist.eu/banner/vas-slug.png" width="468" height="60" alt="Hlasujte pro nás na MineListu">
</a>Doporučený postup
- Veřejné statistiky ukládejte do cache aspoň na minutu a nevolejte API při každém zobrazení stránky.
- API klíč nikdy nevkládejte do kódu na straně prohlížeče ani do veřejného repozitáře.
- Endpoint pro vyzvednutí volejte jen jednou na jednu odměnu.