MineList API lar serveren din sjekke om en spiller har stemt, gi en belønning nøyaktig én gang og lese offentlig statistikk. Alle endepunktene returnerer JSON og bruker enkle HTTPS GET-kall, så de fungerer fra ethvert programmeringsspråk.
Slik får du API-nøkkelen din
Legg til serveren din, ta den over og åpne eierpanelet. API-nøkkelen vises på innstillingssiden til serveren. Hold den privat, siden den identifiserer serveren din. Hvis den lekker ut, genererer du en ny i panelet og oppdaterer pluginen eller skriptet ditt.
Basisadressen for alle endepunktene er https://minelist.eu.
Sjekk en stemme
GET /api/v1/vote?key=API_KEY&username=NICKForteller om spilleren har stemt i dag og om belønningen allerede er løst inn.
{"voted":true,"claimed":false,"next_vote_utc":"2026-10-31T00:00:00Z"}voteder true hvis nicket har en stemme på serveren din i den gjeldende UTC-dagen.claimeder true hvis du allerede har markert stemmen som innløst.next_vote_utcer tidspunktet da spilleren kan stemme igjen.
Løs inn en stemme
GET /api/v1/vote/claim?key=API_KEY&username=NICKMarkerer dagens stemme som innløst. Kall den rett før du deler ut belønningen, slik at en spiller ikke kan hente den to ganger. Mulige svar:
| Svar | Betydning |
|---|---|
{"voted":true,"claimed":true} | Stemmen var gyldig og er nå innløst. Gi belønningen. |
{"voted":true,"claimed":false,"already_claimed":true} | Stemmen var allerede innløst tidligere. Ikke gi noe. |
{"voted":false,"claimed":false} | Spilleren har ikke stemt i dag. |
Vis stemmene denne måneden
GET /api/v1/votes?key=API_KEYReturnerer alle stemmene serveren din har fått i den gjeldende måneden. Det er nyttig for månedlige belønninger til toppstemmere og for topplister på din egen nettside.
Offentlig serverstatistikk
GET /api/v1/server/<slug>Dette endepunktet trenger ingen nøkkel. Slug er den siste delen av serveradressen på MineList. Eksempler på felt i svaret:
| Felt | Beskrivelse |
|---|---|
name | Servernavn |
url | Nettsiden til serveren |
ip | Tilkoblingsadresse |
online | Om den siste kontrollen lyktes |
players | Spillere online ved siste kontroll |
max_players | Antall spillerplasser |
version | Serverversjon |
votes_month | Stemmer denne måneden |
votes_total | Stemmer siden serveren ble lagt til |
uptime_30 | Oppetid de siste 30 dagene i prosent |
rating | Gjennomsnittlig vurdering |
last_check | Tidspunktet for siste kontroll |
Eksempel med curl
Dette er hele logikken i shell-form. Alle språk som kan sende en HTTP-forespørsel, for eksempel Java, PHP, Python eller Node.js, gjør det samme.
curl -s "https://minelist.eu/api/v1/vote/claim?key=API_KEY&username=Steve"Tolk JSON-svaret, og hvis claimed er true, kjører du belønningskommandoen din, for eksempel give Steve diamond 3.
Støtte for NuVotifier
Hvis du foretrekker umiddelbare belønninger uten å spørre om nye stemmer hele tiden, kan MineList sende stemmene til serveren din via NuVotifier. Begge protokollversjonene støttes. Versjon 1 bruker en offentlig RSA-nøkkel, versjon 2 bruker et token.
- Installer NuVotifier på serveren din og start den på nytt.
- Skriv inn vert, port (8192 som standard) og den offentlige nøkkelen (v1) eller tokenet (v2) i eierpanelet.
- Trykk på Send teststemme og sjekk at serveren logger stemmen.
Hvis testen mislykkes, må du sørge for at Votifier-porten er åpen i brannmuren din og at nøkkelen er kopiert uten mellomrom eller linjeskift.
Live-banner
Hver server har et live-banner på 468x60 piksler som viser gjeldende status og antall spillere:
https://minelist.eu/banner/<slug>.pngEksempel på HTML-innbygging:
<a href="https://minelist.eu/no/server/din-slug">
<img src="https://minelist.eu/banner/din-slug.png" width="468" height="60" alt="Stem på oss på MineList">
</a>God praksis
- Mellomlagre den offentlige statistikken i minst ett minutt i stedet for å kalle API-et ved hver sidevisning.
- Legg aldri API-nøkkelen i kode på klientsiden eller i et offentlig repository.
- Bruk endepunktet for innløsing bare én gang per belønning.