mcserverliste.eu

API-Dokumentation

Basis-URL: https://mcserverliste.eu/api/v1. Den API-Key findest du in deinem Dashboard. Übergib ihn als Header X-API-Key oder als Parameter ?key=. Limit: 120 Anfragen pro Minute.

Vote prüfen

GET /api/v1/votes/check?username=Steve
X-API-Key: DEIN_KEY
{
  "username": "Steve",
  "voted": true,
  "claimed": false,
  "votedAt": "2026-11-15T18:00:00.000Z",
  "nextVoteAt": "2026-11-16T18:00:00.000Z"
}

voted ist true, wenn der Spieler in den letzten 24 Stunden gevotet hat.

Belohnung abholen

POST /api/v1/votes/claim
X-API-Key: DEIN_KEY
Content-Type: application/json

{ "username": "Steve" }
{ "username": "Steve", "claimed": true }

claimed: true kommt nur einmal pro Vote. So kann ein Spieler die Belohnung nicht doppelt abholen. Gib die Belohnung nur dann aus.

Server-Statistik

GET /api/v1/server
X-API-Key: DEIN_KEY
{
  "id": 1, "name": "ShroomSMP", "online": true, "players": 42, "maxPlayers": 200,
  "votes": 812, "rank": 3,
  "periodStart": "2026-11-15T00:00:00.000Z", "periodEnd": "2026-11-30T00:00:00.000Z"
}

votes zählt alle Votes seit dem letzten Reset. Die Votes werden alle 15 Tage auf 0 gesetzt.

NuVotifier

Trag in deinem Server-Eintrag Host, Port und Token von NuVotifier ein. Bei jedem Vote schicken wir den Vote direkt an deinen Server (Protokoll V2). Im Dashboard kannst du die Verbindung testen.