Meistgevotet Jetzt online Neueste Bedrock Survival Skyblock Minispiele Wirtschaft
Für Serverbesitzer

API für Serverbesitzer

Verbinde deinen Server oder deine Website direkt mit MinecraftList — du lädst dir Votes, die Rangliste der Abstimmenden sowie die Liste der Spieler herunter, die bei dir spielen. Das eignet sich für Vote-Belohnungen, Statistiken oder eigene Übersichten. Den API-Schlüssel findest du in Änderungen an deinem Server.

Wie man einen Schlüssel erhält Endpointy Beispiele Limity Spielerverifizierung

Wie man einen Schlüssel erhält

  1. Melde dich an und öffne Anpassungen deines Servers (Profil → Meine Server → Bearbeiten, oder Schaltfläche Bearbeiten im Serverprofil).
  2. Im Panel API für Besitzer Klicke auf Schlüssel generieren.
  3. Der Schlüssel wird angezeigt. nur einmal — Kopiere ihn dir sofort. In der Datenbank speichern wir nur seinen Fingerabdruck, daher können wir ihn später nicht mehr anzeigen. Wenn du ihn verlierst, generiere dir einen neuen (der alte wird dadurch sofort ungültig).

Der Schlüssel wird direkt in der Adresse gesendet (/api/v1/{klíč}/…), sodass er auch aus einem Browser oder einem einfachen Skript verwendet werden kann. Zeige ihn niemandem — jeder, der ihn hat, sieht deine Statistiken. Wenn er nach außen gelangt, tausche den Schlüssel aus (oder widerrufe ihn).

Endpointy

Die Grundlage ist https://minecraftlist.eu/api/v1/{klíč}. Alles wird als JSON zurückgegeben.

Metoda Cesta Was gibt es zurück?
GET /info Serverübersicht (Status, Spieler, Adresse, Spielmodi) und Stimmen (heute, pro Monat, insgesamt) + Schlüsselstatus und ausgeschöpfte Limits.
GET /votes/month Stimmen für den aktuellen Monat. ?nickname=Nick schränkt auf einen Spieler ein, ?merge=1 gibt Summen statt einzelner Stimmen zurück, ?limit= Anzahl.
GET /votes/{rok}/{měsíc} Stimmen für einen bestimmten Monat (dieselben Optionen wie oben), z. B. /votes/2026/9.
GET /votes/top Aktivste Abstimmende. ?period=30d (oder 7d, all) a ?limit=25 (max 100).
GET /votes/player/{nick} Status eines Spielers: wie viele Stimmen er abgegeben hat, wann zuletzt und wann er wieder kann.
GET /votes/player/{nick}/next Nur die Zeit bis zum nächsten möglichen Vote (geeignet für ein Plugin — du musst nichts berechnen).
GET /players Liste der Spieler, die der Server gemeldet hat (siehe unten).
POST /players Hochladen der Server-Spieler — Body {"players": ["Nick1", "Nick2"]} oder {"nickname": "Nick"} (kann auch als Text gesendet werden, Zeilen = Nicknamen).

Beispiele

Serverübersicht:

curl "https://minecraftlist.eu/api/v1/TVUJ_KLIC/info"

Rangliste der Abstimmenden der letzten 30 Tage (die 25 aktivsten):

curl "https://minecraftlist.eu/api/v1/TVUJ_KLIC/votes/top?period=30d&limit=25"

Wann kann ein Spieler Notch hlasovat znovu:

curl "https://minecraftlist.eu/api/v1/TVUJ_KLIC/votes/player/Notch/next"

Laden von Spielern vom Server (z. B. aus einem Plugin nach dem Login eines Spielers):

curl -X POST "https://minecraftlist.eu/api/v1/TVUJ_KLIC/players" \
  -H "Content-Type: application/json" \
  -d '{"players": ["Notch", "jeb_"]}'

Die Antwort sieht so aus (gekürzt):

{
  "player": {
    "nickname": "Notch",
    "votes": 12,
    "last_vote_at": "2026-09-23T11:05:00+02:00",
    "next_vote_at": "2026-09-23T23:05:00+02:00",
    "can_vote_now": false,
    "known_by_server": true
  }
}

Limits und Verhalten

Spielerüberprüfung

Wenn uns der Server eine Liste seiner Spieler schickt (POST /players), können wir bei Bewertungen überprüfen, dass der Verfasser wirklich auf dem Server spielt — und ein solcher Spieler erhält bei der Bewertung ein Abzeichen. Die Liste verwaltest du selbst, es genügt, sie fortlaufend zu senden (ruhig einzeln pro Spieler beim Verbinden).

Brauchst du noch etwas – ein anderes Datenformat, mehr Datensätze oder eine Anbindung an ein konkretes Plugin? Schreib uns an Kontaktformular und wir einigen uns.

Kopiert