Met de MineList API kan je server controleren of een speler heeft gestemd, een beloning precies één keer uitdelen en openbare statistieken uitlezen. Alle endpoints geven JSON terug en gebruiken gewone HTTPS GET-verzoeken, dus ze werken vanuit elke programmeertaal.
Je API-sleutel ophalen
Voeg je server toe, claim hem en open het eigenaarspaneel. De API-sleutel staat op de instellingenpagina van de server. Houd hem privé, want hij identificeert je server. Lekt hij uit, genereer dan in het paneel een nieuwe sleutel en werk je plugin of script bij.
Het basisadres van alle endpoints is https://minelist.eu.
Een stem controleren
GET /api/v1/vote?key=API_KEY&username=NICKLaat zien of de speler vandaag heeft gestemd en of de beloning al is opgehaald.
{"voted":true,"claimed":false,"next_vote_utc":"2026-10-31T00:00:00Z"}votedis true als de naam in de huidige UTC-dag een stem voor jouw server heeft.claimedis true als je die stem al als opgehaald hebt gemarkeerd.next_vote_utcis het tijdstip waarop de speler weer mag stemmen.
Een stem claimen
GET /api/v1/vote/claim?key=API_KEY&username=NICKMarkeert de stem van vandaag als opgehaald. Roep dit aan vlak voordat je de beloning uitdeelt, zodat een speler niet twee keer kan innen. Mogelijke antwoorden:
| Antwoord | Betekenis |
|---|---|
{"voted":true,"claimed":true} | De stem was geldig en is nu opgehaald. Geef de beloning. |
{"voted":true,"claimed":false,"already_claimed":true} | De stem was al eerder opgehaald. Geef niets. |
{"voted":false,"claimed":false} | De speler heeft vandaag niet gestemd. |
Stemmen van deze maand opvragen
GET /api/v1/votes?key=API_KEYGeeft alle stemmen terug die je server in de huidige maand heeft ontvangen. Handig voor beloningen voor de topstemmers van de maand en voor ranglijsten op je eigen website.
Openbare serverstatistieken
GET /api/v1/server/<slug>Voor dit endpoint is geen sleutel nodig. De slug is het laatste deel van het serveradres op MineList. Voorbeeld van velden in het antwoord:
| Veld | Beschrijving |
|---|---|
name | Servernaam |
url | Website van de server |
ip | Verbindingsadres |
online | Of de laatste controle is geslaagd |
players | Spelers online bij de laatste controle |
max_players | Maximaal aantal spelers |
version | Serverversie |
votes_month | Stemmen deze maand |
votes_total | Stemmen sinds de server is toegevoegd |
uptime_30 | Uptime in de afgelopen 30 dagen in procenten |
rating | Gemiddelde beoordeling |
last_check | Tijdstip van de laatste controle |
Voorbeeld met curl
Dit is de hele logica in shellvorm. Elke taal die een HTTP-verzoek kan versturen, zoals Java, PHP, Python of Node.js, doet hetzelfde.
curl -s "https://minelist.eu/api/v1/vote/claim?key=API_KEY&username=Steve"Verwerk de JSON en voer, als claimed true is, je beloningscommando uit, bijvoorbeeld give Steve diamond 3.
NuVotifier-ondersteuning
Wil je liever directe beloningen zonder polling, dan kan MineList stemmen via NuVotifier naar je server sturen. Beide protocolversies worden ondersteund. Versie 1 gebruikt een openbare RSA-sleutel, versie 2 een token.
- Installeer NuVotifier op je server en herstart hem.
- Vul in het eigenaarspaneel de host, de poort (standaard 8192) en de openbare sleutel (v1) of het token (v2) in.
- Klik op Teststem versturen en controleer of je server de stem registreert.
Mislukt de test, controleer dan of de Votifier-poort openstaat in je firewall en of de sleutel zonder spaties of regeleinden is gekopieerd.
Live banner
Elke server heeft een live banner van 468x60 pixels die de actuele status en het aantal spelers toont:
https://minelist.eu/banner/<slug>.pngVoorbeeld voor insluiten in HTML:
<a href="https://minelist.eu/nl/server/jouw-slug">
<img src="https://minelist.eu/banner/jouw-slug.png" width="468" height="60" alt="Stem op ons via MineList">
</a>Praktische tips
- Cache openbare statistieken minstens een minuut in plaats van de API bij elke paginaweergave aan te roepen.
- Zet de API-sleutel nooit in code aan de clientzijde of in een openbare repository.
- Gebruik het claim-endpoint maar één keer per beloning.